Для AI-агентов: markdown этой страницы — /docs/api-content.mdиндекс документации — /llms.txt
REST: content
Обновлено
REST: content
Операции этой группы относятся к текущему Hub REST-контракту. В каждой записи приведены полные request/response, ошибки, auth, scopes, headers, pagination и idempotency из принятого producer. Для requiredScopes действует ALL; между auth alternatives действует OR, внутри одной альтернативы — ALL. Пустой список scopes не отменяет указанную аутентификацию. HTTP 304 остаётся отдельным ответом без тела. Не переносите чужие лимиты или заголовки: ниже перечислены только объявленные значения данной операции. Адреса объектов и курсоры описаны в идентификаторах, авторизация — в руководстве, диагностика — в ошибках.
getContentPublishStatus
GET /api/v1/content/publish/{draftHandle} — Poll the unified content write outcome
Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии.
{
"contract": {
"auth": {
"alternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"schemes": {
"hubApiKey": {
"in": "header",
"name": "X-Api-Key",
"type": "apiKey"
},
"hubBearer": {
"scheme": "bearer",
"type": "http"
}
}
},
"errors": {
"401": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Missing or invalid credential",
"headers": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
}
},
"403": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Required content:read scope or resource policy refused",
"headers": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
}
},
"404": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Draft handle is absent or belongs to another tenant",
"headers": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
}
},
"429": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Request budget exhausted",
"headers": {
"Retry-After": {
"description": "Retry delay in seconds when supplied by the limiter",
"schema": {
"type": "integer"
}
},
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
}
}
},
"headers": {
"request": [],
"response": {
"200": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
},
"401": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
},
"403": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
},
"404": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
},
"429": {
"Retry-After": {
"description": "Retry delay in seconds when supplied by the limiter",
"schema": {
"type": "integer"
}
},
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
}
}
},
"idempotency": {
"boundary": null,
"contract": null,
"parameters": []
},
"operationId": "getContentPublishStatus",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": null,
"parameters": [
{
"in": "path",
"name": "draftHandle",
"required": true,
"schema": {
"type": "string"
}
}
]
},
"response": {
"200": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"autoDisabledProviders": {
"items": {
"type": "string"
},
"type": "array"
},
"draftHandle": {
"type": "string"
},
"error": {
"type": "string"
},
"seqNum": {
"exclusiveMinimum": 0,
"type": "integer"
},
"status": {
"enum": [
"pending",
"publishing",
"published",
"failed",
"cancelled"
],
"type": "string"
}
},
"required": [
"draftHandle",
"status"
],
"type": "object"
}
}
},
"description": "Current write status",
"headers": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
}
}
},
"scopes": [
"content:read"
]
},
"evidence": {
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/content.json",
"implementationSha": "d72419fe1977a9f007e45254783a4a389711fb8c",
"registrar": "registerContentPaths",
"result": "accepted",
"selection": "operations[operationId=getContentPublishStatus]",
"source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent"
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "get",
"operationId": "getContentPublishStatus",
"path": "/api/v1/content/publish/{draftHandle}",
"requestSchemaRef": null,
"requiredScopes": [
"content:read"
],
"responseSchemaRefs": {
"200": "#/components/schemas/ContentWriteStatus",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails",
"404": "#/components/schemas/ProblemDetails",
"429": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
200
],
"title": "Poll the unified content write outcome"
}
}publishContent
POST /api/v1/content/publish — Write a pack of content cards into Settings topics
Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии.
{
"contract": {
"auth": {
"alternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"schemes": {
"hubApiKey": {
"in": "header",
"name": "X-Api-Key",
"type": "apiKey"
},
"hubBearer": {
"scheme": "bearer",
"type": "http"
}
}
},
"errors": {
"400": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Invalid canonical write input or missing Idempotency-Key",
"headers": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
}
},
"401": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Missing, invalid or conflicting credential headers; JWT is not accepted",
"headers": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
}
},
"403": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Required content:write scope or resource policy refused",
"headers": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
}
},
"409": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Tenant archived or same idempotency command is in flight",
"headers": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
}
},
"413": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "The pack exceeds the current plan item cap",
"headers": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
}
},
"422": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Idempotency-Key was reused with different request input",
"headers": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
}
},
"429": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Request budget exhausted",
"headers": {
"Retry-After": {
"description": "Retry delay in seconds when supplied by the limiter",
"schema": {
"type": "integer"
}
},
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
}
}
},
"headers": {
"request": [
{
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"type": "string"
}
}
],
"response": {
"201": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
},
"400": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
},
"401": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
},
"403": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
},
"409": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
},
"413": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
},
"422": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
},
"429": {
"Retry-After": {
"description": "Retry delay in seconds when supplied by the limiter",
"schema": {
"type": "integer"
}
},
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
}
}
},
"idempotency": {
"boundary": null,
"contract": null,
"parameters": [
{
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"type": "string"
}
}
]
},
"operationId": "publishContent",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"items": {
"items": {
"additionalProperties": false,
"properties": {
"config": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"buttons": {
"additionalProperties": false,
"properties": {
"button_target": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"delivery_message"
],
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"url"
],
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"web_app"
],
"type": "string"
},
"web_app_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"web_app_url"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"section_root"
],
"type": "string"
},
"section": {
"enum": [
"catalog",
"booking",
"events"
],
"type": "string"
}
},
"required": [
"kind",
"section"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"entity_seq": {
"exclusiveMinimum": 0,
"type": "integer"
},
"entity_type": {
"enum": [
"product",
"catalog_group",
"menu_group",
"event",
"resource",
"chain_step",
"marketing_campaign",
"marketing_link",
"form"
],
"type": "string"
},
"kind": {
"enum": [
"deeplink"
],
"type": "string"
}
},
"required": [
"kind",
"entity_type",
"entity_seq"
],
"type": "object"
}
]
},
"button_title": {
"maxLength": 100,
"type": "string"
}
},
"type": "object"
},
"delivery": {
"additionalProperties": false,
"properties": {
"message_content_seq_num": {
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
}
},
"type": "object"
},
"flags": {
"additionalProperties": false,
"properties": {
"is_active": {
"type": "boolean"
},
"is_create_order_on_click": {
"type": "boolean"
},
"is_deferred_payment": {
"type": "boolean"
},
"is_private_access": {
"type": "boolean"
},
"is_public": {
"type": "boolean"
},
"is_public_subscription_required": {
"type": "boolean"
},
"purchase_limit_per_user": {
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"item_type": {
"enum": [
"product",
"service",
"digital",
"delivery"
],
"type": "string"
},
"measurement_unit": {
"maxLength": 32,
"type": "string"
},
"prices": {
"items": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,2})?$",
"type": [
"string",
"null"
]
},
"currency": {
"enum": [
"RUB",
"USD",
"EUR"
],
"type": "string"
},
"trial_amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,2})?$",
"type": [
"string",
"null"
]
}
},
"required": [
"currency",
"amount",
"trial_amount"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"amount": {
"minimum": 0,
"type": [
"integer",
"null"
]
},
"currency": {
"enum": [
"XTR"
],
"type": "string"
},
"trial_amount": {
"type": "null"
}
},
"required": [
"currency",
"amount",
"trial_amount"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": [
"string",
"null"
]
},
"currency": {
"enum": [
"USDT",
"TON",
"BTC",
"ETH",
"LTC",
"BNB",
"TRX",
"USDC"
],
"type": "string"
},
"trial_amount": {
"type": "null"
}
},
"required": [
"currency",
"amount",
"trial_amount"
],
"type": "object"
}
]
},
"type": "array"
},
"requires_postal_code": {
"type": "boolean"
},
"sku_code": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"subscription": {
"additionalProperties": false,
"properties": {
"enabled": {
"type": "boolean"
},
"period_days": {
"maximum": 365,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"title": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"trial": {
"additionalProperties": false,
"properties": {
"days": {
"maximum": 365,
"minimum": 1,
"type": "integer"
},
"enabled": {
"type": "boolean"
}
},
"type": "object"
}
},
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"autoSendDeferredPayment": {
"type": "boolean"
},
"buttonIconCustomEmojiId": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"buttonStyle": {
"maxLength": 16,
"type": [
"string",
"null"
]
},
"buttonTarget": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"delivery_message"
],
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"url"
],
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"web_app"
],
"type": "string"
},
"web_app_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"web_app_url"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"section_root"
],
"type": "string"
},
"section": {
"enum": [
"catalog",
"booking",
"events"
],
"type": "string"
}
},
"required": [
"kind",
"section"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"entity_seq": {
"exclusiveMinimum": 0,
"type": "integer"
},
"entity_type": {
"enum": [
"product",
"catalog_group",
"menu_group",
"event",
"resource",
"chain_step",
"marketing_campaign",
"marketing_link",
"form"
],
"type": "string"
},
"kind": {
"enum": [
"deeplink"
],
"type": "string"
}
},
"required": [
"kind",
"entity_type",
"entity_seq"
],
"type": "object"
},
{
"type": "null"
}
]
},
"buttonTitle": {
"maxLength": 100,
"type": [
"string",
"null"
]
},
"buttonUrl": {
"not": {},
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"group": {
"enum": [
"in_progress",
"success",
"fail"
],
"type": "string"
},
"isUserNotificationEnabled": {
"type": "boolean"
},
"sort": {
"type": "integer"
},
"title": {
"maxLength": 100,
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"buttonIconCustomEmojiId": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"buttonStyle": {
"maxLength": 16,
"type": [
"string",
"null"
]
},
"buttonTarget": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"delivery_message"
],
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"url"
],
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"web_app"
],
"type": "string"
},
"web_app_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"web_app_url"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"section_root"
],
"type": "string"
},
"section": {
"enum": [
"catalog",
"booking",
"events"
],
"type": "string"
}
},
"required": [
"kind",
"section"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"entity_seq": {
"exclusiveMinimum": 0,
"type": "integer"
},
"entity_type": {
"enum": [
"product",
"catalog_group",
"menu_group",
"event",
"resource",
"chain_step",
"marketing_campaign",
"marketing_link",
"form"
],
"type": "string"
},
"kind": {
"enum": [
"deeplink"
],
"type": "string"
}
},
"required": [
"kind",
"entity_type",
"entity_seq"
],
"type": "object"
},
{
"type": "null"
}
]
},
"buttonTitle": {
"maxLength": 100,
"type": [
"string",
"null"
]
},
"buttonUrl": {
"not": {},
"type": "string"
},
"isAwaitingReply": {
"type": "boolean"
},
"messageTtlMinutes": {
"minimum": 0,
"type": [
"integer",
"null"
]
},
"savedSegmentSeqNum": {
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": [
"integer",
"null"
]
},
"schedule": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"atLocal": {
"type": "string"
},
"kind": {
"enum": [
"once"
],
"type": "string"
}
},
"required": [
"kind",
"atLocal"
],
"type": "object"
},
{
"type": "null"
}
]
},
"segmentFilter": {
"additionalProperties": false,
"properties": {
"exclude": {
"items": {
"additionalProperties": false,
"properties": {
"amountGte": {
"minimum": 0,
"type": "number"
},
"groupTargetIds": {
"items": {
"pattern": "^\\d+$",
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"key": {
"minLength": 1,
"type": "string"
},
"kind": {
"enum": [
"preset",
"recipe",
"tag",
"purchase_amount",
"user_event",
"commerce",
"event",
"booking",
"form",
"channel",
"campaign",
"chain",
"chain_step",
"broadcast",
"manual"
],
"type": "string"
},
"period": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"days": {
"maximum": 3650,
"minimum": 1,
"type": "integer"
},
"mode": {
"enum": [
"last_days"
],
"type": "string"
}
},
"required": [
"mode",
"days"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"days": {
"maximum": 3650,
"minimum": 1,
"type": "integer"
},
"mode": {
"enum": [
"older_days"
],
"type": "string"
}
},
"required": [
"mode",
"days"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"from": {
"format": "date-time",
"type": "string"
},
"mode": {
"enum": [
"between"
],
"type": "string"
},
"to": {
"format": "date-time",
"type": "string"
}
},
"required": [
"mode",
"from",
"to"
],
"type": "object"
}
]
},
"targetIds": {
"items": {
"pattern": "^\\d+$",
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"userIds": {
"items": {
"pattern": "^\\d+$",
"type": "string"
},
"maxItems": 5000,
"minItems": 1,
"type": "array"
}
},
"required": [
"kind",
"key"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"include": {
"items": {
"additionalProperties": false,
"properties": {
"any": {
"items": {
"additionalProperties": false,
"properties": {
"amountGte": {
"minimum": 0,
"type": "number"
},
"groupTargetIds": {
"items": {
"pattern": "^\\d+$",
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"key": {
"minLength": 1,
"type": "string"
},
"kind": {
"enum": [
"preset",
"recipe",
"tag",
"purchase_amount",
"user_event",
"commerce",
"event",
"booking",
"form",
"channel",
"campaign",
"chain",
"chain_step",
"broadcast",
"manual"
],
"type": "string"
},
"period": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"days": {
"maximum": 3650,
"minimum": 1,
"type": "integer"
},
"mode": {
"enum": [
"last_days"
],
"type": "string"
}
},
"required": [
"mode",
"days"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"days": {
"maximum": 3650,
"minimum": 1,
"type": "integer"
},
"mode": {
"enum": [
"older_days"
],
"type": "string"
}
},
"required": [
"mode",
"days"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"from": {
"format": "date-time",
"type": "string"
},
"mode": {
"enum": [
"between"
],
"type": "string"
},
"to": {
"format": "date-time",
"type": "string"
}
},
"required": [
"mode",
"from",
"to"
],
"type": "object"
}
]
},
"targetIds": {
"items": {
"pattern": "^\\d+$",
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"userIds": {
"items": {
"pattern": "^\\d+$",
"type": "string"
},
"maxItems": 5000,
"minItems": 1,
"type": "array"
}
},
"required": [
"kind",
"key"
],
"type": "object"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
}
},
"required": [
"any"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
}
},
"required": [
"include",
"exclude"
],
"type": [
"object",
"null"
]
},
"segmentLabels": {
"type": [
"string",
"null"
]
},
"target": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"delivery_message"
],
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"url"
],
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"web_app"
],
"type": "string"
},
"web_app_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"web_app_url"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"section_root"
],
"type": "string"
},
"section": {
"enum": [
"catalog",
"booking",
"events"
],
"type": "string"
}
},
"required": [
"kind",
"section"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"entity_seq": {
"exclusiveMinimum": 0,
"type": "integer"
},
"entity_type": {
"enum": [
"product",
"catalog_group",
"menu_group",
"event",
"resource",
"chain_step",
"marketing_campaign",
"marketing_link",
"form"
],
"type": "string"
},
"kind": {
"enum": [
"deeplink"
],
"type": "string"
}
},
"required": [
"kind",
"entity_type",
"entity_seq"
],
"type": "object"
},
{
"type": "null"
}
]
},
"title": {
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"buttonIconCustomEmojiId": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"buttonStyle": {
"maxLength": 16,
"type": [
"string",
"null"
]
},
"buttonTarget": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"delivery_message"
],
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"url"
],
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"web_app"
],
"type": "string"
},
"web_app_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"web_app_url"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"section_root"
],
"type": "string"
},
"section": {
"enum": [
"catalog",
"booking",
"events"
],
"type": "string"
}
},
"required": [
"kind",
"section"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"entity_seq": {
"exclusiveMinimum": 0,
"type": "integer"
},
"entity_type": {
"enum": [
"product",
"catalog_group",
"menu_group",
"event",
"resource",
"chain_step",
"marketing_campaign",
"marketing_link",
"form"
],
"type": "string"
},
"kind": {
"enum": [
"deeplink"
],
"type": "string"
}
},
"required": [
"kind",
"entity_type",
"entity_seq"
],
"type": "object"
},
{
"type": "null"
}
]
},
"buttonTitle": {
"maxLength": 100,
"type": [
"string",
"null"
]
},
"buttonUrl": {
"not": {},
"type": "string"
},
"displayName": {
"minLength": 1,
"type": "string"
},
"isActive": {
"type": "boolean"
},
"target": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"delivery_message"
],
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"url"
],
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"web_app"
],
"type": "string"
},
"web_app_url": {
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"web_app_url"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"section_root"
],
"type": "string"
},
"section": {
"enum": [
"catalog",
"booking",
"events"
],
"type": "string"
}
},
"required": [
"kind",
"section"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"entity_seq": {
"exclusiveMinimum": 0,
"type": "integer"
},
"entity_type": {
"enum": [
"product",
"catalog_group",
"menu_group",
"event",
"resource",
"chain_step",
"marketing_campaign",
"marketing_link",
"form"
],
"type": "string"
},
"kind": {
"enum": [
"deeplink"
],
"type": "string"
}
},
"required": [
"kind",
"entity_type",
"entity_seq"
],
"type": "object"
}
]
}
},
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"step": {
"additionalProperties": false,
"properties": {
"delayMinutes": {
"minimum": 0,
"type": "integer"
},
"title": {
"maxLength": 255,
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"title": {
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"startAt": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
]
}
},
"type": "object"
}
],
"description": "Entity fields for the chosen targetTopic. Each topic admits its OWN shape; a mismatch is rejected."
},
"content": {
"additionalProperties": false,
"description": "Channel-agnostic content payload.",
"properties": {
"mediaRefs": {
"default": [],
"description": "Immutable descriptors from media_finalize. URLs and bytes are forbidden.",
"items": {
"additionalProperties": false,
"properties": {
"caption": {
"maxLength": 1024,
"type": "string"
},
"captionEntities": {
"items": {
"additionalProperties": false,
"properties": {
"custom_emoji_id": {
"type": "string"
},
"language": {
"type": "string"
},
"length": {
"exclusiveMinimum": 0,
"type": "integer"
},
"offset": {
"minimum": 0,
"type": "integer"
},
"type": {
"enum": [
"mention",
"hashtag",
"cashtag",
"bot_command",
"url",
"email",
"phone_number",
"bold",
"italic",
"underline",
"strikethrough",
"spoiler",
"blockquote",
"expandable_blockquote",
"code",
"pre",
"text_link",
"text_mention",
"custom_emoji"
],
"type": "string"
},
"url": {
"type": "string"
},
"user": {
"additionalProperties": false,
"properties": {
"firstName": {
"type": "string"
},
"id": {
"pattern": "^-?\\d+$",
"type": "string"
},
"lastName": {
"type": "string"
},
"username": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
}
},
"required": [
"type",
"offset",
"length"
],
"type": "object"
},
"type": "array"
},
"captionHtml": {
"maxLength": 16384,
"minLength": 1,
"type": "string"
},
"expectedSizeBytes": {
"exclusiveMinimum": 0,
"maximum": 4294967296,
"type": "integer"
},
"generatedFileName": {
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"kind": {
"enum": [
"voice",
"audio",
"video_note"
],
"type": "string"
},
"mediaRef": {
"maxLength": 512,
"pattern": "^media-ingress\\/v1\\/[a-f0-9]{64}\\/[A-Za-z0-9_-]{16,128}\\/objects\\/[a-z][a-z0-9-]{0,63}\\/[a-f0-9]{64}\\/[a-f0-9]{24}\\.blob$",
"type": "string"
},
"mimeType": {
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"sha256": {
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"type": {
"enum": [
"photo",
"video",
"document"
],
"type": "string"
}
},
"required": [
"type",
"mediaRef",
"expectedSizeBytes",
"sha256",
"mimeType"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"sourceUrl": {
"description": "Page to parse once into the card text. No periodic sync.",
"format": "uri",
"type": "string"
},
"text": {
"description": "Telegram HTML message text. Max 4096 chars.",
"maxLength": 4096,
"type": "string"
}
},
"type": "object"
},
"intent": {
"default": "CREATE",
"description": "CREATE a new card, REPLACE the content of an existing one, or RESTORE a soft-deleted one.",
"enum": [
"CREATE",
"REPLACE",
"RESTORE"
],
"type": "string"
},
"replaceTarget": {
"additionalProperties": false,
"description": "REPLACE / RESTORE only — which existing card to swap.",
"properties": {
"kind": {
"description": "Which content to swap — the entity's own card, or its delivery message.",
"enum": [
"card",
"delivery"
],
"type": "string"
},
"seqId": {
"description": "Per-client seq of the entity to replace.",
"exclusiveMinimum": 0,
"type": "integer"
}
},
"required": [
"kind"
],
"type": "object"
},
"targetTopic": {
"description": "Which Settings-SG content topic this card belongs to.",
"enum": [
"catalog",
"order_statuses",
"marketing",
"broadcasts",
"message_chains",
"events"
],
"type": "string"
},
"waitResult": {
"default": false,
"description": "true = wait for the published entity and return its seqId; false = return the draftId immediately.",
"type": "boolean"
}
},
"required": [
"targetTopic",
"content"
],
"type": "object"
},
"minItems": 1,
"type": "array"
}
},
"required": [
"items"
],
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"results": {
"items": {
"additionalProperties": false,
"properties": {
"autoDisabledProviders": {
"items": {
"type": "string"
},
"type": "array"
},
"draftHandle": {
"type": "string"
},
"error": {
"type": "string"
},
"index": {
"minimum": 0,
"type": "integer"
},
"seqNum": {
"exclusiveMinimum": 0,
"type": "integer"
},
"status": {
"enum": [
"pending",
"publishing",
"published",
"failed",
"cancelled"
],
"type": "string"
},
"waitTimedOut": {
"type": "boolean"
}
},
"required": [
"index"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"results"
],
"type": "object"
}
}
},
"description": "Pack accepted; inspect every indexed result for partial failures or waiting timeout",
"headers": {
"X-Bot-Username": {
"description": "Active public bot username, when resolved",
"schema": {
"type": "string"
}
},
"X-Client-Slug": {
"description": "Active tenant slug, when resolved",
"schema": {
"type": "string"
}
},
"X-RateLimit-Limit": {
"description": "Effective request budget",
"schema": {
"type": "string"
}
},
"X-RateLimit-Remaining": {
"description": "Remaining budget or unknown",
"schema": {
"type": "string"
}
},
"X-RateLimit-Reset": {
"description": "Window reset, Unix seconds",
"schema": {
"type": "string"
}
}
}
}
},
"scopes": [
"content:write"
]
},
"evidence": {
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/content.json",
"implementationSha": "d72419fe1977a9f007e45254783a4a389711fb8c",
"registrar": "registerContentPaths",
"result": "accepted",
"selection": "operations[operationId=publishContent]",
"source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent"
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "publishContent",
"path": "/api/v1/content/publish",
"requestSchemaRef": "#/components/schemas/ContentPublishRequest",
"requiredScopes": [
"content:write"
],
"responseSchemaRefs": {
"201": "#/components/schemas/ContentPublishResult",
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails",
"409": "#/components/schemas/ProblemDetails",
"413": "#/components/schemas/ProblemDetails",
"422": "#/components/schemas/ProblemDetails",
"429": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "Write a pack of content cards into Settings topics"
}
}