Skip to content
Errorgram

File unavailable · file.unavailable

Stable ID: file.unavailable · Evidence: source derived

The file could not be downloaded with the supplied identifier.

The source notes that this path also hides upstream 5xx and 429 errors. The response supplies no retry delay and does not prove that the ID is wrong.

When it matches

Section titled “When it matches”

Every field in a rule must match. Alternative rules are joined with OR. Codes below are JSON response fields, not inferred HTTP statuses.

  • JSON error_code: 400.

Exact description:

Bad Request: wrong file_id or the file is temporarily unavailable

See matching rules for parameter precedence and unknown or ambiguous results.

Illustrative methods: getFile.

Possible causes

Section titled “Possible causes”
  • A started download stopped before completion without an active shutdown or logout state.

Before deciding what to do

Section titled “Before deciding what to do”

Application decision: check file and retry policy. Repeat request: after relevant change.

  • Verify the file_id; if a temporary failure is plausible, apply a bounded retry policy without inventing a server delay.

These are application choices. Errorgram does not retry, suppress the error, or change bot state.

Facts

Section titled “Facts”

This condition adds no extracted facts; result.facts is empty.

Example

Section titled “Example”

Synthetic examples derived from the cited source.

API method: getFile.

{
  "ok": false,
  "error_code": 400,
  "description": "Bad Request: wrong file_id or the file is temporarily unavailable"
}

Python

Section titled “Python”
from errorgram import classify


response = {
    "ok": False,
    "error_code": 400,
    "description": "Bad Request: wrong file_id or the file is temporarily unavailable",
}
result = classify(response, method='getFile')


assert result.id == 'file.unavailable'
print(result.entry["summary"])

JavaScript and TypeScript

Section titled “JavaScript and TypeScript”
import { classify } from "errorgram";


const response = {
  "ok": false,
  "error_code": 400,
  "description": "Bad Request: wrong file_id or the file is temporarily unavailable"
};
const result = classify(response, { method: "getFile" });


if (result.status === "matched" && result.id === "file.unavailable") {
  console.log(result.entry.summary);
}

Framework names

Section titled “Framework names”
Integration Type or ID
Python errorgram.FileUnavailable
aiogram errorgram.aiogram.FileUnavailable extends TelegramBadRequest
grammY EnrichedGrammyError with classification.id equal to file.unavailable

Enrichment is explicit and keeps framework catch compatibility. Follow the Python and aiogram guide or JavaScript, TypeScript, and grammY guide.

Evidence

Section titled “Evidence”

Source references identify the reviewed revision, not the first release that introduced this response.

Data and versions

Section titled “Data and versions”

Catalogue 0.1.0 · schema 1.0.0 · reviewed 2026-09-16.

Markdown · Condition JSON · Full catalogue and sources · JSON Schema