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

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

publishContent

Обновлено

POST /api/v1/content/publish

Write a pack of content cards into Settings topics

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

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.in"header"
0.name"Idempotency-Key"
0.requiredtrue
0.schema0.schema

Тело запроса

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

Ответы

ПолеЗначение
201.content.application/json.schemaContentPublishResult
201.description"Pack accepted; inspect every indexed result for partial failures or waiting timeout"
201.headers.X-Bot-Username.description"Active public bot username, when resolved"
201.headers.X-Bot-Username.schema201.headers.X-Bot-Username.schema
201.headers.X-Client-Slug.description"Active tenant slug, when resolved"
201.headers.X-Client-Slug.schema201.headers.X-Client-Slug.schema
201.headers.X-RateLimit-Limit.description"Effective request budget"
201.headers.X-RateLimit-Limit.schema201.headers.X-RateLimit-Limit.schema
201.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
201.headers.X-RateLimit-Remaining.schema201.headers.X-RateLimit-Remaining.schema
201.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
201.headers.X-RateLimit-Reset.schema201.headers.X-RateLimit-Reset.schema

Ошибки

ПолеЗначение
400.content.application/problem+json.schemaProblemDetails
400.description"Invalid canonical write input or missing Idempotency-Key"
400.headers.X-Bot-Username.description"Active public bot username, when resolved"
400.headers.X-Bot-Username.schema400.headers.X-Bot-Username.schema
400.headers.X-Client-Slug.description"Active tenant slug, when resolved"
400.headers.X-Client-Slug.schema400.headers.X-Client-Slug.schema
400.headers.X-RateLimit-Limit.description"Effective request budget"
400.headers.X-RateLimit-Limit.schema400.headers.X-RateLimit-Limit.schema
400.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
400.headers.X-RateLimit-Remaining.schema400.headers.X-RateLimit-Remaining.schema
400.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
400.headers.X-RateLimit-Reset.schema400.headers.X-RateLimit-Reset.schema
401.content.application/problem+json.schemaProblemDetails
401.description"Missing, invalid or conflicting credential headers; JWT is not accepted"
401.headers.X-Bot-Username.description"Active public bot username, when resolved"
401.headers.X-Bot-Username.schema401.headers.X-Bot-Username.schema
401.headers.X-Client-Slug.description"Active tenant slug, when resolved"
401.headers.X-Client-Slug.schema401.headers.X-Client-Slug.schema
401.headers.X-RateLimit-Limit.description"Effective request budget"
401.headers.X-RateLimit-Limit.schema401.headers.X-RateLimit-Limit.schema
401.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
401.headers.X-RateLimit-Remaining.schema401.headers.X-RateLimit-Remaining.schema
401.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
401.headers.X-RateLimit-Reset.schema401.headers.X-RateLimit-Reset.schema
403.content.application/problem+json.schemaProblemDetails
403.description"Required content:write scope or resource policy refused"
403.headers.X-Bot-Username.description"Active public bot username, when resolved"
403.headers.X-Bot-Username.schema403.headers.X-Bot-Username.schema
403.headers.X-Client-Slug.description"Active tenant slug, when resolved"
403.headers.X-Client-Slug.schema403.headers.X-Client-Slug.schema
403.headers.X-RateLimit-Limit.description"Effective request budget"
403.headers.X-RateLimit-Limit.schema403.headers.X-RateLimit-Limit.schema
403.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
403.headers.X-RateLimit-Remaining.schema403.headers.X-RateLimit-Remaining.schema
403.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
403.headers.X-RateLimit-Reset.schema403.headers.X-RateLimit-Reset.schema
409.content.application/problem+json.schemaProblemDetails
409.description"Tenant archived or same idempotency command is in flight"
409.headers.X-Bot-Username.description"Active public bot username, when resolved"
409.headers.X-Bot-Username.schema409.headers.X-Bot-Username.schema
409.headers.X-Client-Slug.description"Active tenant slug, when resolved"
409.headers.X-Client-Slug.schema409.headers.X-Client-Slug.schema
409.headers.X-RateLimit-Limit.description"Effective request budget"
409.headers.X-RateLimit-Limit.schema409.headers.X-RateLimit-Limit.schema
409.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
409.headers.X-RateLimit-Remaining.schema409.headers.X-RateLimit-Remaining.schema
409.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
409.headers.X-RateLimit-Reset.schema409.headers.X-RateLimit-Reset.schema
413.content.application/problem+json.schemaProblemDetails
413.description"The pack exceeds the current plan item cap"
413.headers.X-Bot-Username.description"Active public bot username, when resolved"
413.headers.X-Bot-Username.schema413.headers.X-Bot-Username.schema
413.headers.X-Client-Slug.description"Active tenant slug, when resolved"
413.headers.X-Client-Slug.schema413.headers.X-Client-Slug.schema
413.headers.X-RateLimit-Limit.description"Effective request budget"
413.headers.X-RateLimit-Limit.schema413.headers.X-RateLimit-Limit.schema
413.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
413.headers.X-RateLimit-Remaining.schema413.headers.X-RateLimit-Remaining.schema
413.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
413.headers.X-RateLimit-Reset.schema413.headers.X-RateLimit-Reset.schema
422.content.application/problem+json.schemaProblemDetails
422.description"Idempotency-Key was reused with different request input"
422.headers.X-Bot-Username.description"Active public bot username, when resolved"
422.headers.X-Bot-Username.schema422.headers.X-Bot-Username.schema
422.headers.X-Client-Slug.description"Active tenant slug, when resolved"
422.headers.X-Client-Slug.schema422.headers.X-Client-Slug.schema
422.headers.X-RateLimit-Limit.description"Effective request budget"
422.headers.X-RateLimit-Limit.schema422.headers.X-RateLimit-Limit.schema
422.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
422.headers.X-RateLimit-Remaining.schema422.headers.X-RateLimit-Remaining.schema
422.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
422.headers.X-RateLimit-Reset.schema422.headers.X-RateLimit-Reset.schema
429.content.application/problem+json.schemaProblemDetails
429.description"Request budget exhausted"
429.headers.Retry-After.description"Retry delay in seconds when supplied by the limiter"
429.headers.Retry-After.schema429.headers.Retry-After.schema
429.headers.X-Bot-Username.description"Active public bot username, when resolved"
429.headers.X-Bot-Username.schema429.headers.X-Bot-Username.schema
429.headers.X-Client-Slug.description"Active tenant slug, when resolved"
429.headers.X-Client-Slug.schema429.headers.X-Client-Slug.schema
429.headers.X-RateLimit-Limit.description"Effective request budget"
429.headers.X-RateLimit-Limit.schema429.headers.X-RateLimit-Limit.schema
429.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
429.headers.X-RateLimit-Remaining.schema429.headers.X-RateLimit-Remaining.schema
429.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
429.headers.X-RateLimit-Reset.schema429.headers.X-RateLimit-Reset.schema

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

ПолеЗначение
description"Each item uses the canonical unified write validator. The targetTopic selects its config; CREATE forbids replaceTarget, REPLACE/RESTORE require its tenant seqId, and delivery replacement is limited to catalog/marketing. Catalog config delivery.message_content_seq_num is a strict numeric positive-int4 address resolved within the tenant; the raw message_content_id key is refused. RESTORE excludes message_chains. Content requires text, finalized media descriptors or a source page URL. The plan sets the batch cap; per-item failures remain in results, without failing successful siblings. waitResult changes waiting, not durable item identity. Poll unresolved cards by their opaque draftHandle. Authentication accepts X-Api-Key OR Bearer tgf_* credential secrets; surface-session JWTs are refused."
operationId"publishContent"
summary"Write a pack of content cards into Settings topics"
tags["content"]
x-scope-semantics"ALL"