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

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

listBroadcasts

Обновлено

GET /api/v1/tools/broadcasts

listBroadcasts

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

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["broadcasts:read"]

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

ПолеЗначение
Параметры[]

Тело запроса

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

Ответы

ПолеЗначение
200.content.application/json.schemaBroadcastList
200.description"Actual tenant broadcast projection; preparation does not enqueue, execution only queues and status reports latest execution"
200.headers.X-Bot-Username.description"Active public bot username when supplied"
200.headers.X-Bot-Username.schema200.headers.X-Bot-Username.schema
200.headers.X-Client-Slug.description"Active tenant slug when authenticated metadata supplies it"
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 in Unix seconds"
200.headers.X-RateLimit-Reset.schema200.headers.X-RateLimit-Reset.schema

Ошибки

ПолеЗначение
401.content.application/problem+json.schemaProblemDetails
401.description"INVALID_API_KEY: missing, malformed, conflicting or revoked credentials; JWT refused"
401.headers.X-Bot-Username.description"Active public bot username when supplied"
401.headers.X-Bot-Username.schema401.headers.X-Bot-Username.schema
401.headers.X-Client-Slug.description"Active tenant slug when authenticated metadata supplies it"
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 in Unix seconds"
401.headers.X-RateLimit-Reset.schema401.headers.X-RateLimit-Reset.schema
403.content.application/problem+json.schemaProblemDetails
403.description"INSUFFICIENT_SCOPE, PUBLISHABLE_KEY_NOT_ALLOWED or NO_ACTIVE_BOT"
403.headers.X-Bot-Username.description"Active public bot username when supplied"
403.headers.X-Bot-Username.schema403.headers.X-Bot-Username.schema
403.headers.X-Client-Slug.description"Active tenant slug when authenticated metadata supplies it"
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 in Unix seconds"
403.headers.X-RateLimit-Reset.schema403.headers.X-RateLimit-Reset.schema
413.content.application/problem+json.schemaProblemDetails
413.description"PAYLOAD_TOO_LARGE or ITEM_COUNT_EXCEEDED"
413.headers.X-Bot-Username.description"Active public bot username when supplied"
413.headers.X-Bot-Username.schema413.headers.X-Bot-Username.schema
413.headers.X-Client-Slug.description"Active tenant slug when authenticated metadata supplies it"
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 in Unix seconds"
413.headers.X-RateLimit-Reset.schema413.headers.X-RateLimit-Reset.schema
429.content.application/problem+json.schemaProblemDetails
429.description"RATE_LIMIT_EXCEEDED or RATE_LIMIT_UNAVAILABLE; fail closed"
429.headers.Retry-After.description"Retry delay in seconds when supplied by resource limiter"
429.headers.Retry-After.schema429.headers.Retry-After.schema
429.headers.X-Bot-Username.description"Active public bot username when supplied"
429.headers.X-Bot-Username.schema429.headers.X-Bot-Username.schema
429.headers.X-Client-Slug.description"Active tenant slug when authenticated metadata supplies it"
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 in Unix seconds"
429.headers.X-RateLimit-Reset.schema429.headers.X-RateLimit-Reset.schema
500.content.application/problem+json.schemaProblemDetails
500.description"INTERNAL_ERROR; private failure detail is withheld"
500.headers.X-Bot-Username.description"Active public bot username when supplied"
500.headers.X-Bot-Username.schema500.headers.X-Bot-Username.schema
500.headers.X-Client-Slug.description"Active tenant slug when authenticated metadata supplies it"
500.headers.X-Client-Slug.schema500.headers.X-Client-Slug.schema
500.headers.X-RateLimit-Limit.description"Effective request budget"
500.headers.X-RateLimit-Limit.schema500.headers.X-RateLimit-Limit.schema
500.headers.X-RateLimit-Remaining.description"Remaining budget or unknown"
500.headers.X-RateLimit-Remaining.schema500.headers.X-RateLimit-Remaining.schema
500.headers.X-RateLimit-Reset.description"Window reset in Unix seconds"
500.headers.X-RateLimit-Reset.schema500.headers.X-RateLimit-Reset.schema

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

ПолеЗначение
description"X-Api-Key OR Authorization: Bearer tgf_* are alternative API-key transports. Surface-session JWT is refused. Every required scope must be present. Tenant-local sequences resolve only under authenticated client metadata. Operator work stays in Telegram."
operationId"listBroadcasts"
tags["broadcasts"]
x-idempotencynull
x-paginationnull