# executeBroadcastLaunch

Source: <https://telegafirst.com/docs/api-op-executebroadcastlaunch>
Locale: ru
releaseGitSha: ea133cd4ad87fe549ef000b139be145be9bd1717
sourceContentDigest: ed94d2c0b7fa6c13c94ae96cf145ee8287ff479ddef6f1e30ecb5d17981570dc
Version: 2

# executeBroadcastLaunch

`POST /api/v1/tools/broadcasts/execute-launch`

executeBroadcastLaunch

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

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

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

| Поле | Значение |
| - | - |
| 0.in | "header" |
| 0.name | "Idempotency-Key" |
| 0.required | true |
| 0.schema | [0.schema](https://telegafirst.com/docs/schema-9ac136edb99a2063b3091602181c8d2022fdccb5b514991319d58544c2e57e95) |

## Тело запроса

| Поле | Значение |
| - | - |
| content.application/json.schema | [BroadcastLaunchExecuteRequest](https://telegafirst.com/docs/schema-23dcec1bca720a171320266103316ff11700db3522595a526007385fa195fb5f) |
| required | true |

## Ответы

| Поле | Значение |
| - | - |
| 202.content.application/json.schema | [BroadcastLaunchQueued](https://telegafirst.com/docs/schema-4181313e69fb70672195ff33fbcfd22464045fed939de116a6058168d3f8be69) |
| 202.description | "Actual tenant broadcast projection; preparation does not enqueue, execution only queues and status reports latest execution" |
| 202.headers.X-Bot-Username.description | "Active public bot username when supplied" |
| 202.headers.X-Bot-Username.schema | [202.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 202.headers.X-Client-Slug.description | "Active tenant slug when authenticated metadata supplies it" |
| 202.headers.X-Client-Slug.schema | [202.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 202.headers.X-RateLimit-Limit.description | "Effective request budget" |
| 202.headers.X-RateLimit-Limit.schema | [202.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 202.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 202.headers.X-RateLimit-Remaining.schema | [202.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 202.headers.X-RateLimit-Reset.description | "Window reset in Unix seconds" |
| 202.headers.X-RateLimit-Reset.schema | [202.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |

## Ошибки

| Поле | Значение |
| - | - |
| 400.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 400.description | "VALIDATION\_ERROR; POST body also requires IDEMPOTENCY\_KEY\_REQUIRED" |
| 400.headers.X-Bot-Username.description | "Active public bot username when supplied" |
| 400.headers.X-Bot-Username.schema | [400.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 400.headers.X-Client-Slug.description | "Active tenant slug when authenticated metadata supplies it" |
| 400.headers.X-Client-Slug.schema | [400.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 400.headers.X-RateLimit-Limit.description | "Effective request budget" |
| 400.headers.X-RateLimit-Limit.schema | [400.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 400.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 400.headers.X-RateLimit-Remaining.schema | [400.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 400.headers.X-RateLimit-Reset.description | "Window reset in Unix seconds" |
| 400.headers.X-RateLimit-Reset.schema | [400.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 401.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 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.schema | [401.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 401.headers.X-Client-Slug.description | "Active tenant slug when authenticated metadata supplies it" |
| 401.headers.X-Client-Slug.schema | [401.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 401.headers.X-RateLimit-Limit.description | "Effective request budget" |
| 401.headers.X-RateLimit-Limit.schema | [401.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 401.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 401.headers.X-RateLimit-Remaining.schema | [401.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 401.headers.X-RateLimit-Reset.description | "Window reset in Unix seconds" |
| 401.headers.X-RateLimit-Reset.schema | [401.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 403.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 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.schema | [403.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 403.headers.X-Client-Slug.description | "Active tenant slug when authenticated metadata supplies it" |
| 403.headers.X-Client-Slug.schema | [403.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 403.headers.X-RateLimit-Limit.description | "Effective request budget" |
| 403.headers.X-RateLimit-Limit.schema | [403.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 403.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 403.headers.X-RateLimit-Remaining.schema | [403.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 403.headers.X-RateLimit-Reset.description | "Window reset in Unix seconds" |
| 403.headers.X-RateLimit-Reset.schema | [403.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 404.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 404.description | "NOT\_FOUND: sequence absent or foreign to authenticated tenant" |
| 404.headers.X-Bot-Username.description | "Active public bot username when supplied" |
| 404.headers.X-Bot-Username.schema | [404.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 404.headers.X-Client-Slug.description | "Active tenant slug when authenticated metadata supplies it" |
| 404.headers.X-Client-Slug.schema | [404.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 404.headers.X-RateLimit-Limit.description | "Effective request budget" |
| 404.headers.X-RateLimit-Limit.schema | [404.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 404.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 404.headers.X-RateLimit-Remaining.schema | [404.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 404.headers.X-RateLimit-Reset.description | "Window reset in Unix seconds" |
| 404.headers.X-RateLimit-Reset.schema | [404.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 409.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 409.description | "CONFLICT: command processing, invalid launch state or stale prepared revision" |
| 409.headers.X-Bot-Username.description | "Active public bot username when supplied" |
| 409.headers.X-Bot-Username.schema | [409.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 409.headers.X-Client-Slug.description | "Active tenant slug when authenticated metadata supplies it" |
| 409.headers.X-Client-Slug.schema | [409.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 409.headers.X-RateLimit-Limit.description | "Effective request budget" |
| 409.headers.X-RateLimit-Limit.schema | [409.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 409.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 409.headers.X-RateLimit-Remaining.schema | [409.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 409.headers.X-RateLimit-Reset.description | "Window reset in Unix seconds" |
| 409.headers.X-RateLimit-Reset.schema | [409.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 413.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 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.schema | [413.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 413.headers.X-Client-Slug.description | "Active tenant slug when authenticated metadata supplies it" |
| 413.headers.X-Client-Slug.schema | [413.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 413.headers.X-RateLimit-Limit.description | "Effective request budget" |
| 413.headers.X-RateLimit-Limit.schema | [413.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 413.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 413.headers.X-RateLimit-Remaining.schema | [413.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 413.headers.X-RateLimit-Reset.description | "Window reset in Unix seconds" |
| 413.headers.X-RateLimit-Reset.schema | [413.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 422.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 422.description | "IDEMPOTENCY\_KEY\_MISMATCH on divergent replay; mapped domain input errors normalize to VALIDATION\_ERROR" |
| 422.headers.X-Bot-Username.description | "Active public bot username when supplied" |
| 422.headers.X-Bot-Username.schema | [422.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 422.headers.X-Client-Slug.description | "Active tenant slug when authenticated metadata supplies it" |
| 422.headers.X-Client-Slug.schema | [422.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 422.headers.X-RateLimit-Limit.description | "Effective request budget" |
| 422.headers.X-RateLimit-Limit.schema | [422.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 422.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 422.headers.X-RateLimit-Remaining.schema | [422.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 422.headers.X-RateLimit-Reset.description | "Window reset in Unix seconds" |
| 422.headers.X-RateLimit-Reset.schema | [422.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 429.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 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.schema | [429.headers.Retry-After.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 429.headers.X-Bot-Username.description | "Active public bot username when supplied" |
| 429.headers.X-Bot-Username.schema | [429.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 429.headers.X-Client-Slug.description | "Active tenant slug when authenticated metadata supplies it" |
| 429.headers.X-Client-Slug.schema | [429.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 429.headers.X-RateLimit-Limit.description | "Effective request budget" |
| 429.headers.X-RateLimit-Limit.schema | [429.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 429.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 429.headers.X-RateLimit-Remaining.schema | [429.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 429.headers.X-RateLimit-Reset.description | "Window reset in Unix seconds" |
| 429.headers.X-RateLimit-Reset.schema | [429.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 500.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 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.schema | [500.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 500.headers.X-Client-Slug.description | "Active tenant slug when authenticated metadata supplies it" |
| 500.headers.X-Client-Slug.schema | [500.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 500.headers.X-RateLimit-Limit.description | "Effective request budget" |
| 500.headers.X-RateLimit-Limit.schema | [500.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 500.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 500.headers.X-RateLimit-Remaining.schema | [500.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 500.headers.X-RateLimit-Reset.description | "Window reset in Unix seconds" |
| 500.headers.X-RateLimit-Reset.schema | [500.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |

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

| Поле | Значение |
| - | - |
| 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 | "executeBroadcastLaunch" |
| tags | \["broadcasts"] |
| x-idempotency.mismatchStatus | 422 |
| x-idempotency.required | true |
| x-idempotency.ttlSeconds | 86400 |
| x-pagination | null |