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

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

confirmSupergroups

Обновлено

POST /api/v1/tools/onboarding/supergroups/confirm

confirmSupergroups

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

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["onboarding:write"]

Параметры запроса

ПолеЗначение
0.description"Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key."
0.in"header"
0.name"Idempotency-Key"
0.requiredtrue
0.schema0.schema

Тело запроса

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

Ответы

ПолеЗначение
201.content.application/json.schema201.content.application/json.schema
201.description"Onboarding result and next action."

Ошибки

ПолеЗначение
400.content.application/problem+json.schemaProblemDetails
400.description"Invalid input or missing idempotency key."
401.content.application/problem+json.schemaProblemDetails
401.description"Authentication required."
403.content.application/problem+json.schemaProblemDetails
403.description"Operation is not permitted."
409.content.application/problem+json.schemaProblemDetails
409.description"SG_DISCOVERY_STALE: the group list changed since discovery; read the discovery again with refresh=1 and confirm its new fingerprint. CONFLICT: the confirmation could not be applied."
422.content.application/problem+json.schemaProblemDetails
422.description"SG_NOT_FORUM, SA_NOT_MEMBER, SA_NOT_ADMIN, SA_RIGHTS_MISSING or SA_ANONYMOUS: a selected group is not ready; fix it in Telegram, refresh the discovery and confirm again."

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

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