Что такое TelegaFirst?

AI-фронт-офис в Telegram для микробизнеса.

Где работает оператор?

Видит все важные разговоры в Telegram-супергруппе и может перехватить их одной кнопкой.

Первого бота можно попробовать бесплатно.

Для AI-агентов: markdown этой страницы — /docs/api-op-finalizemediaupload.mdиндекс документации — /llms.txt

Обновлено 4 октября 2026 г.

POST /api/v1/media/uploads/{uploadId}/finalize

finalizeMediaUpload

Scopes: ALL. Auth alternatives: OR; scopes внутри альтернативы: ALL.

Поле	Значение
security.0.hubApiKey	[]
security.1.hubBearer	[]
securitySchemes.hubApiKey.in	"header"
securitySchemes.hubApiKey.name	"X-Api-Key"
securitySchemes.hubApiKey.type	"apiKey"
securitySchemes.hubBearer.scheme	"bearer"
securitySchemes.hubBearer.type	"http"
x-required-scopes	["content:write"]

Поле	Значение
0.description	"Optional 24-hour HTTP replay key for this bodyless POST"
0.in	"header"
0.name	"Idempotency-Key"
0.required	false
0.schema	0.schema
1.in	"path"
1.name	"uploadId"
1.required	true
1.schema	1.schema

Поле	Значение
Тело запроса	null

Поле	Значение
200.content.application/json.schema	200.content.application/json.schema
200.description	"Promoted and committed immutable media references"
200.headers.X-Bot-Username.description	"Authenticated public bot username, when available"
200.headers.X-Bot-Username.schema	200.headers.X-Bot-Username.schema
200.headers.X-Client-Slug.description	"Authenticated tenant slug, when available"
200.headers.X-Client-Slug.schema	200.headers.X-Client-Slug.schema
200.headers.X-RateLimit-Limit.description	"Effective request budget"
200.headers.X-RateLimit-Limit.schema	200.headers.X-RateLimit-Limit.schema
200.headers.X-RateLimit-Remaining.description	"Remaining budget or unknown"
200.headers.X-RateLimit-Remaining.schema	200.headers.X-RateLimit-Remaining.schema
200.headers.X-RateLimit-Reset.description	"Window reset Unix seconds"
200.headers.X-RateLimit-Reset.schema	200.headers.X-RateLimit-Reset.schema

Поле	Значение
401.content.application/problem+json.schema	ProblemDetails
401.description	"Missing or invalid API key"
403.content.application/problem+json.schema	ProblemDetails
403.description	"Scope or resource policy refused the request"
404.content.application/problem+json.schema	ProblemDetails
404.description	"Upload does not exist for the authenticated tenant"
409.content.application/problem+json.schema	ProblemDetails
409.description	"CONFLICT: durable outcome differs or HTTP replay key is processing"
413.content.application/problem+json.schema	ProblemDetails
413.description	"PAYLOAD_TOO_LARGE or ITEM_COUNT_EXCEEDED: per-tool resource limits"
422.content.application/problem+json.schema	ProblemDetails
422.description	"VALIDATION_ERROR: invalid upload id or uncommittable state; IDEMPOTENCY_KEY_MISMATCH: different path under the same HTTP key"
429.content.application/problem+json.schema	ProblemDetails
429.description	"RATE_LIMIT_EXCEEDED or RATE_LIMIT_UNAVAILABLE: resource budget refusal"
429.headers.Retry-After.description	"Retry delay in seconds, when supplied by the limiter"
429.headers.Retry-After.schema	429.headers.Retry-After.schema
500.content.application/problem+json.schema	ProblemDetails
500.description	"INTERNAL_ERROR: unexpected failure; no internal payload is exposed"