К содержанию
TelegaFirst

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

requestMediaUpload

Обновлено

POST /api/v1/media/uploads

requestMediaUpload

Авторизация и права

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"Required for a nonempty POST body by the canonical 24-hour HTTP response receipt."
0.in"header"
0.name"Idempotency-Key"
0.requiredtrue
0.schema0.schema

Тело запроса

ПолеЗначение
content.application/json.schemacontent.application/json.schema
requiredtrue

Ответы

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

Ошибки

ПолеЗначение
400.content.application/problem+json.schemaProblemDetails
400.description"VALIDATION_ERROR: malformed upload request; IDEMPOTENCY_KEY_REQUIRED: missing nonempty POST key"
401.content.application/problem+json.schemaProblemDetails
401.description"Missing or invalid API key"
403.content.application/problem+json.schemaProblemDetails
403.description"PLAN_UPGRADE_REQUIRED: the plan has no media upload (details.plan); otherwise scope or resource policy refused the request"
409.content.application/problem+json.schemaProblemDetails
409.description"MEDIA_MANIFEST_CONFLICT: this idempotency_key was already used for other files; CONFLICT: HTTP replay key is processing"
413.content.application/problem+json.schemaProblemDetails
413.description"PAYLOAD_TOO_LARGE or ITEM_COUNT_EXCEEDED: per-tool resource limits"
422.content.application/problem+json.schemaProblemDetails
422.description"MEDIA_TOO_LARGE, MEDIA_BATCH_TOO_LARGE (details.limitBytes, details.plan), MEDIA_TOO_MANY_FILES (details.limitFiles); VALIDATION_ERROR: file declaration violates media policy; IDEMPOTENCY_KEY_MISMATCH: different request under the same HTTP key"
429.content.application/problem+json.schemaProblemDetails
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.schema429.headers.Retry-After.schema
500.content.application/problem+json.schemaProblemDetails
500.description"INTERNAL_ERROR: unexpected failure; no internal payload is exposed"

Дополнительные условия

ПолеЗначение
operationId"requestMediaUpload"
tags["media"]
x-idempotency"http-cache"