Reference
Uploaded file status
Read one of this connection's files again: pending (waiting for the PUT), checking, ready (with storagePath), used, rejected (with `code`), expired.
View MarkdownThis page is generated from the source code on every release.
Read one of this connection's files again: pending (waiting for the PUT), checking, ready (with storagePath), used, rejected (with code), expired.
Overview
| Name | Value |
|---|---|
| Code | files.status |
| Scope needed | messages.send |
| Risk | Read |
| May need confirmation | No |
| Runs as | Answers right away |
Needs Idempotency-Key |
No |
| Member roles allowed | owner, manager, agent |
| In the app | Assistant (Build 2.1) |
Input fields
| Field | Type | Required | Description |
|---|---|---|---|
uploadId |
uuid |
Yes |
Example request
curl -X POST https://tlg.builera.app/api/public/v2/ops/files.status \
-H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"uploadId":"00000000-0000-0000-0000-000000000000"}'Output fields (data)
| Field | Type | Required |
|---|---|---|
ok |
true |
Yes |
uploadId |
text |
Yes |
status |
"expired" | "pending" | "checking" | "ready" | "rejected" | "used" |
Yes |
purpose |
"message" | "campaign" | "photo" | "story" |
Yes |
accountId |
null | text |
Yes |
campaignId |
null | text |
Yes |
fileName |
text |
Yes |
storagePath |
null | text |
Yes |
kind |
null | "video" | "photo" | "audio" | "voice" | "document" |
Yes |
mime |
null | text |
Yes |
size |
null | number |
Yes |
sha256 |
null | text |
Yes |
code |
null | text |
Yes |
uploadExpiresAt |
text |
Yes |
readyExpiresAt |
null | text |
Yes |
usedAt |
null | text |
Yes |
Example answer
{
"data": {
"ok": true,
"uploadId": "00000000-0000-4000-8000-000000000000",
"status": "expired",
"purpose": "message",
"accountId": "00000000-0000-4000-8000-000000000000",
"campaignId": "00000000-0000-4000-8000-000000000000",
"fileName": "text",
"storagePath": "text",
"kind": "video",
"mime": "text",
"size": 1,
"sha256": "text",
"code": "text",
"uploadExpiresAt": "2026-10-22T12:00:00.000Z",
"readyExpiresAt": "2026-10-22T12:00:00.000Z",
"usedAt": "2026-10-22T12:00:00.000Z"
}
}Using it over MCP
Not listed on any profile: call tools_describe then tools_run with code: "files.status". Tool name when listed: files_status.