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

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

cancelExternalContentDraft

Обновлено

DELETE /api/v1/tools/external-content-publish/{draftHandle}

Cancel a pending content draft

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

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"path"
0.name"draftHandle"
0.requiredtrue
0.schema0.schema
1.in"header"
1.name"Idempotency-Key"
1.requiredfalse
1.schema1.schema

Тело запроса

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

Ответы

ПолеЗначение
204.description"Pending draft cancelled; no response body"
204.headers.X-Bot-Username.description"Active public bot username, when resolved"
204.headers.X-Bot-Username.schema204.headers.X-Bot-Username.schema
204.headers.X-Client-Slug.description"Active tenant slug, when resolved"
204.headers.X-Client-Slug.schema204.headers.X-Client-Slug.schema
204.headers.X-RateLimit-Limit.description"Effective request budget"
204.headers.X-RateLimit-Limit.schema204.headers.X-RateLimit-Limit.schema
204.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
204.headers.X-RateLimit-Remaining.schema204.headers.X-RateLimit-Remaining.schema
204.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
204.headers.X-RateLimit-Reset.schema204.headers.X-RateLimit-Reset.schema

Ошибки

ПолеЗначение
400.content.application/problem+json.schemaProblemDetails
400.description"Invalid draft input"
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 or invalid credential"
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
404.content.application/problem+json.schemaProblemDetails
404.description"Draft is absent or belongs to another tenant"
404.headers.X-Bot-Username.description"Active public bot username, when resolved"
404.headers.X-Bot-Username.schema404.headers.X-Bot-Username.schema
404.headers.X-Client-Slug.description"Active tenant slug, when resolved"
404.headers.X-Client-Slug.schema404.headers.X-Client-Slug.schema
404.headers.X-RateLimit-Limit.description"Effective request budget"
404.headers.X-RateLimit-Limit.schema404.headers.X-RateLimit-Limit.schema
404.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
404.headers.X-RateLimit-Remaining.schema404.headers.X-RateLimit-Remaining.schema
404.headers.X-RateLimit-Reset.description"Window reset, Unix seconds"
404.headers.X-RateLimit-Reset.schema404.headers.X-RateLimit-Reset.schema
409.content.application/problem+json.schemaProblemDetails
409.description"Draft is no longer pending or the idempotent 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
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"Only pending drafts can be cancelled. A bodyless DELETE does not require Idempotency-Key; supplying it enables a 24-hour actor/tenant/route/handle-bound replay. Changed params with the same key yield 422 IDEMPOTENCY_KEY_MISMATCH. A completed replay has no response body. This operation has no pagination. Bearer accepts tgf_* credential secrets, not surface-session JWTs."
operationId"cancelExternalContentDraft"
summary"Cancel a pending content draft"
tags["content"]
x-scope-semantics"ALL"