File id missing · file.id_missing

Stable ID: file.id_missing · Evidence: observed

The file_id argument is missing or empty.

This response concerns a missing file identifier; it does not validate an upload or a nonempty identifier.

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: file_id not specified

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

Illustrative methods: getFile.

Possible causes

• The remote-file lookup received an empty file_id.

Before deciding what to do

Application decision: supply file identifier. Repeat request: after relevant change.

• Use the file_id supplied for this bot by Telegram, rather than file_unique_id.

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

Facts

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

Example

Synthetic examples derived from the cited source.

API method: getFile.

{
  "ok": false,
  "error_code": 400,
  "description": "Bad Request: file_id not specified"
}

Python

from errorgram import classify

response = {
    "ok": False,
    "error_code": 400,
    "description": "Bad Request: file_id not specified",
}
result = classify(response, method='getFile')

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

JavaScript and TypeScript

import { classify } from "errorgram";

const response = {
  "ok": false,
  "error_code": 400,
  "description": "Bad Request: file_id not specified"
};
const result = classify(response, { method: "getFile" });

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

Framework names

Integration	Type or ID
Python	errorgram.FileIdMissing
aiogram	errorgram.aiogram.FileIdMissing extends TelegramBadRequest
grammY	EnrichedGrammyError with classification.id equal to file.id_missing

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

Evidence

• Recorded observation. getFile with an empty file_id returned this description. Accessed 2026-09-16.
• Bot API 10.3 · telegram-bot-api/Client.cpp:9034–9041. The remote-file helper directly rejects an empty file_id. Revision e3e9dd8e5b3d7ab8537cd5a10dc31d5ffa8f82d1.
• Bot API 10.3 · telegram-bot-api/Client.cpp:17032–17035. getFile passes its file_id argument to the helper. Revision e3e9dd8e5b3d7ab8537cd5a10dc31d5ffa8f82d1.

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

Data and versions

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

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