# REST: marketing Source: Locale: ru releaseGitSha: c9a428d902de0b479a981e43774f38b9ec077ed7 sourceContentDigest: 225f91ee392c74c098924fab5cb4c2ab0133173b449dd083ff036b2f57d7866b Version: 1 # REST: marketing Операции этой группы относятся к текущему Hub REST-контракту. В каждой записи приведены полные request/response, ошибки, auth, scopes, headers, pagination и idempotency из принятого producer. Для requiredScopes действует ALL; между auth alternatives действует OR, внутри одной альтернативы — ALL. Пустой список scopes не отменяет указанную аутентификацию. HTTP 304 остаётся отдельным ответом без тела. Не переносите чужие лимиты или заголовки: ниже перечислены только объявленные значения данной операции. Адреса объектов и курсоры описаны в [идентификаторах](https://telegafirst.com/docs/identifiers-and-pagination), авторизация — в [руководстве](https://telegafirst.com/docs/authorization), диагностика — в [ошибках](https://telegafirst.com/docs/errors). ## listMarketingCampaigns `GET /api/v1/tools/marketing` — Authenticate with X-Api-Key or Authorization: Bearer tgf\_\* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code. Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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": "INVALID_API_KEY: absent, invalid, revoked or conflicting key headers; session JWT refused", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "INSUFFICIENT_SCOPE or resource/plan refusal", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "PAYLOAD_TOO_LARGE or ITEM_COUNT_EXCEEDED", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "RATE_LIMIT_EXCEEDED or RATE_LIMIT_UNAVAILABLE", "headers": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } }, "500": { "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": "INTERNAL_ERROR without private implementation detail", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "headers": { "request": [], "response": { "200": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "401": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "403": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "413": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "429": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "500": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "idempotency": { "boundary": null, "contract": null, "parameters": [] }, "operationId": "listMarketingCampaigns", "pagination": { "contract": null, "parameters": [] }, "request": { "body": null, "parameters": [] }, "response": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "campaigns": { "items": { "additionalProperties": false, "properties": { "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": { "type": [ "string", "null" ] }, "displayName": { "type": "string" }, "isActive": { "type": "boolean" }, "links": { "items": { "additionalProperties": false, "properties": { "campaignSeqNum": { "exclusiveMinimum": 0, "type": "integer" }, "comment": { "type": [ "string", "null" ] }, "isActive": { "type": "boolean" }, "kind": { "enum": [ "link", "code_word" ], "type": "string" }, "qrUrl": { "type": "string" }, "qrUrlExpiresAt": { "format": "date-time", "type": "string" }, "seqNum": { "exclusiveMinimum": 0, "type": "integer" }, "title": { "type": "string" }, "wordNormalized": { "type": [ "string", "null" ] } }, "required": [ "seqNum", "campaignSeqNum", "kind", "title", "comment", "wordNormalized", "isActive", "qrUrl", "qrUrlExpiresAt" ], "type": "object" }, "type": "array" }, "seqNum": { "exclusiveMinimum": 0, "type": "integer" }, "statAttributedClosedOrders": { "type": "number" }, "statAttributedOrders": { "type": "number" }, "statClosedOrders": { "type": "number" }, "statExistingUsersClicked": { "type": "number" }, "statNewUsersMonth": { "type": "number" }, "statNewUsersTotal": { "type": "number" }, "statTotalClicksMonth": { "type": "number" }, "statTotalClicksTotal": { "type": "number" }, "statTotalOrders": { "type": "number" }, "statTotalPayments": { "type": "number" }, "statUniqueClicksMonth": { "type": "number" }, "statUniqueClicksTotal": { "type": "number" }, "statUniqueOrders": { "type": "number" }, "statUpdatedAt": { "format": "date-time", "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" } ] } }, "required": [ "seqNum", "displayName", "target", "isActive", "buttonTitle", "buttonTarget", "statTotalClicksTotal", "statNewUsersTotal", "statUniqueClicksTotal", "statTotalClicksMonth", "statNewUsersMonth", "statUniqueClicksMonth", "statExistingUsersClicked", "statTotalOrders", "statTotalPayments", "statClosedOrders", "statUniqueOrders", "statAttributedOrders", "statAttributedClosedOrders", "statUpdatedAt", "links" ], "type": "object" }, "type": "array" } }, "required": [ "campaigns" ], "type": "object" } } }, "description": "Actual control-plane projection; QR signatures expire after 900 seconds", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "scopes": [ "marketing:read" ] }, "evidence": { "fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/marketing.json", "implementationSha": "d72419fe1977a9f007e45254783a4a389711fb8c", "registrar": "registerMarketingPaths", "result": "accepted", "selection": "operations[operationId=listMarketingCampaigns]", "source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent" }, "operation": { "authAlternatives": [ { "hubApiKey": [] }, { "hubBearer": [] } ], "method": "get", "operationId": "listMarketingCampaigns", "path": "/api/v1/tools/marketing", "requestSchemaRef": null, "requiredScopes": [ "marketing:read" ], "responseSchemaRefs": { "200": "#/components/schemas/MarketingCampaignListResponse", "401": "#/components/schemas/ProblemDetails", "403": "#/components/schemas/ProblemDetails", "413": "#/components/schemas/ProblemDetails", "429": "#/components/schemas/ProblemDetails", "500": "#/components/schemas/ProblemDetails" }, "successStatuses": [ 200 ], "title": "Authenticate with X-Api-Key or Authorization: Bearer tgf_* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code." } } ``` ## listMarketingLinks `GET /api/v1/tools/marketing/links` — Authenticate with X-Api-Key or Authorization: Bearer tgf\_\* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code. Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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": "INVALID_API_KEY: absent, invalid, revoked or conflicting key headers; session JWT refused", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "INSUFFICIENT_SCOPE or resource/plan refusal", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "PAYLOAD_TOO_LARGE or ITEM_COUNT_EXCEEDED", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "RATE_LIMIT_EXCEEDED or RATE_LIMIT_UNAVAILABLE", "headers": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } }, "500": { "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": "INTERNAL_ERROR without private implementation detail", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "headers": { "request": [], "response": { "200": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "401": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "403": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "413": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "429": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "500": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "idempotency": { "boundary": null, "contract": null, "parameters": [] }, "operationId": "listMarketingLinks", "pagination": { "contract": null, "parameters": [] }, "request": { "body": null, "parameters": [] }, "response": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "links": { "items": { "additionalProperties": false, "properties": { "campaignSeqNum": { "exclusiveMinimum": 0, "type": "integer" }, "comment": { "type": [ "string", "null" ] }, "isActive": { "type": "boolean" }, "kind": { "enum": [ "link", "code_word" ], "type": "string" }, "qrUrl": { "type": "string" }, "qrUrlExpiresAt": { "format": "date-time", "type": "string" }, "seqNum": { "exclusiveMinimum": 0, "type": "integer" }, "title": { "type": "string" }, "wordNormalized": { "type": [ "string", "null" ] } }, "required": [ "seqNum", "campaignSeqNum", "kind", "title", "comment", "wordNormalized", "isActive", "qrUrl", "qrUrlExpiresAt" ], "type": "object" }, "type": "array" } }, "required": [ "links" ], "type": "object" } } }, "description": "Actual control-plane projection; QR signatures expire after 900 seconds", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "scopes": [ "marketing:read" ] }, "evidence": { "fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/marketing.json", "implementationSha": "d72419fe1977a9f007e45254783a4a389711fb8c", "registrar": "registerMarketingPaths", "result": "accepted", "selection": "operations[operationId=listMarketingLinks]", "source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent" }, "operation": { "authAlternatives": [ { "hubApiKey": [] }, { "hubBearer": [] } ], "method": "get", "operationId": "listMarketingLinks", "path": "/api/v1/tools/marketing/links", "requestSchemaRef": null, "requiredScopes": [ "marketing:read" ], "responseSchemaRefs": { "200": "#/components/schemas/MarketingLinkListResponse", "401": "#/components/schemas/ProblemDetails", "403": "#/components/schemas/ProblemDetails", "413": "#/components/schemas/ProblemDetails", "429": "#/components/schemas/ProblemDetails", "500": "#/components/schemas/ProblemDetails" }, "successStatuses": [ 200 ], "title": "Authenticate with X-Api-Key or Authorization: Bearer tgf_* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code." } } ``` ## updateMarketingCampaign `PATCH /api/v1/tools/marketing` — Authenticate with X-Api-Key or Authorization: Bearer tgf\_\* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code. Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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": "VALIDATION_ERROR or missing POST IDEMPOTENCY_KEY_REQUIRED", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "INVALID_API_KEY: absent, invalid, revoked or conflicting key headers; session JWT refused", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "INSUFFICIENT_SCOPE or resource/plan refusal", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "NOT_FOUND for a missing or foreign tenant sequence", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "CONFLICT for duplicate identity or in-flight idempotent command", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "PAYLOAD_TOO_LARGE or ITEM_COUNT_EXCEEDED", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "VALIDATION_ERROR for marketing domain input refusal or IDEMPOTENCY_KEY_MISMATCH for divergent retries", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "RATE_LIMIT_EXCEEDED or RATE_LIMIT_UNAVAILABLE", "headers": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } }, "500": { "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": "INTERNAL_ERROR without private implementation detail", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "headers": { "request": [ { "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "type": "string" } } ], "response": { "200": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "400": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "401": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "403": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "404": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "409": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "413": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "422": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "429": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "500": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "idempotency": { "boundary": null, "contract": { "mismatchStatus": 422, "required": false, "ttlSeconds": 86400 }, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "type": "string" } } ] }, "operationId": "updateMarketingCampaign", "pagination": { "contract": null, "parameters": [] }, "request": { "body": { "content": { "application/json": { "schema": { "additionalProperties": false, "description": "Partial patch by tenant-local seq_num. Campaign target supports delivery_message, section_root or deeplink only; button_target excludes delivery_message.", "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" }, { "type": "null" } ] }, "button_title": { "maxLength": 100, "type": [ "string", "null" ] }, "display_name": { "maxLength": 200, "minLength": 1, "type": "string" }, "is_active": { "type": "boolean" }, "seq_num": { "exclusiveMinimum": 0, "type": "integer" }, "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" } ] } }, "required": [ "seq_num" ], "type": "object" } } }, "required": true }, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "type": "string" } } ] }, "response": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "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": { "type": [ "string", "null" ] }, "displayName": { "type": "string" }, "isActive": { "type": "boolean" }, "links": { "items": { "additionalProperties": false, "properties": { "campaignSeqNum": { "exclusiveMinimum": 0, "type": "integer" }, "comment": { "type": [ "string", "null" ] }, "isActive": { "type": "boolean" }, "kind": { "enum": [ "link", "code_word" ], "type": "string" }, "qrUrl": { "type": "string" }, "qrUrlExpiresAt": { "format": "date-time", "type": "string" }, "seqNum": { "exclusiveMinimum": 0, "type": "integer" }, "title": { "type": "string" }, "wordNormalized": { "type": [ "string", "null" ] } }, "required": [ "seqNum", "campaignSeqNum", "kind", "title", "comment", "wordNormalized", "isActive", "qrUrl", "qrUrlExpiresAt" ], "type": "object" }, "type": "array" }, "seqNum": { "exclusiveMinimum": 0, "type": "integer" }, "statAttributedClosedOrders": { "type": "number" }, "statAttributedOrders": { "type": "number" }, "statClosedOrders": { "type": "number" }, "statExistingUsersClicked": { "type": "number" }, "statNewUsersMonth": { "type": "number" }, "statNewUsersTotal": { "type": "number" }, "statTotalClicksMonth": { "type": "number" }, "statTotalClicksTotal": { "type": "number" }, "statTotalOrders": { "type": "number" }, "statTotalPayments": { "type": "number" }, "statUniqueClicksMonth": { "type": "number" }, "statUniqueClicksTotal": { "type": "number" }, "statUniqueOrders": { "type": "number" }, "statUpdatedAt": { "format": "date-time", "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" } ] } }, "required": [ "seqNum", "displayName", "target", "isActive", "buttonTitle", "buttonTarget", "statTotalClicksTotal", "statNewUsersTotal", "statUniqueClicksTotal", "statTotalClicksMonth", "statNewUsersMonth", "statUniqueClicksMonth", "statExistingUsersClicked", "statTotalOrders", "statTotalPayments", "statClosedOrders", "statUniqueOrders", "statAttributedOrders", "statAttributedClosedOrders", "statUpdatedAt", "links" ], "type": "object" } } }, "description": "Actual control-plane projection; QR signatures expire after 900 seconds", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "scopes": [ "marketing:write" ] }, "evidence": { "fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/marketing.json", "implementationSha": "d72419fe1977a9f007e45254783a4a389711fb8c", "registrar": "registerMarketingPaths", "result": "accepted", "selection": "operations[operationId=updateMarketingCampaign]", "source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent" }, "operation": { "authAlternatives": [ { "hubApiKey": [] }, { "hubBearer": [] } ], "method": "patch", "operationId": "updateMarketingCampaign", "path": "/api/v1/tools/marketing", "requestSchemaRef": "#/components/schemas/MarketingCampaignUpdateRequest", "requiredScopes": [ "marketing:write" ], "responseSchemaRefs": { "200": "#/components/schemas/MarketingCampaignResponse", "400": "#/components/schemas/ProblemDetails", "401": "#/components/schemas/ProblemDetails", "403": "#/components/schemas/ProblemDetails", "404": "#/components/schemas/ProblemDetails", "409": "#/components/schemas/ProblemDetails", "413": "#/components/schemas/ProblemDetails", "422": "#/components/schemas/ProblemDetails", "429": "#/components/schemas/ProblemDetails", "500": "#/components/schemas/ProblemDetails" }, "successStatuses": [ 200 ], "title": "Authenticate with X-Api-Key or Authorization: Bearer tgf_* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code." } } ``` ## updateMarketingLink `PATCH /api/v1/tools/marketing/links` — Authenticate with X-Api-Key or Authorization: Bearer tgf\_\* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code. Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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": "VALIDATION_ERROR or missing POST IDEMPOTENCY_KEY_REQUIRED", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "INVALID_API_KEY: absent, invalid, revoked or conflicting key headers; session JWT refused", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "INSUFFICIENT_SCOPE or resource/plan refusal", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "NOT_FOUND for a missing or foreign tenant sequence", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "CONFLICT for duplicate identity or in-flight idempotent command", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "PAYLOAD_TOO_LARGE or ITEM_COUNT_EXCEEDED", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "VALIDATION_ERROR for marketing domain input refusal or IDEMPOTENCY_KEY_MISMATCH for divergent retries", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "RATE_LIMIT_EXCEEDED or RATE_LIMIT_UNAVAILABLE", "headers": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } }, "500": { "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": "INTERNAL_ERROR without private implementation detail", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "headers": { "request": [ { "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "type": "string" } } ], "response": { "200": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "400": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "401": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "403": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "404": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "409": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "413": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "422": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "429": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "500": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "idempotency": { "boundary": null, "contract": { "mismatchStatus": 422, "required": false, "ttlSeconds": 86400 }, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "type": "string" } } ] }, "operationId": "updateMarketingLink", "pagination": { "contract": null, "parameters": [] }, "request": { "body": { "content": { "application/json": { "schema": { "additionalProperties": false, "description": "Patch by tenant-local seq_num. kind and code_word are immutable.", "properties": { "comment": { "maxLength": 255, "type": [ "string", "null" ] }, "is_active": { "type": "boolean" }, "seq_num": { "exclusiveMinimum": 0, "type": "integer" }, "title": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "seq_num" ], "type": "object" } } }, "required": true }, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "type": "string" } } ] }, "response": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "campaignSeqNum": { "exclusiveMinimum": 0, "type": "integer" }, "comment": { "type": [ "string", "null" ] }, "isActive": { "type": "boolean" }, "kind": { "enum": [ "link", "code_word" ], "type": "string" }, "qrUrl": { "type": "string" }, "qrUrlExpiresAt": { "format": "date-time", "type": "string" }, "seqNum": { "exclusiveMinimum": 0, "type": "integer" }, "title": { "type": "string" }, "wordNormalized": { "type": [ "string", "null" ] } }, "required": [ "seqNum", "campaignSeqNum", "kind", "title", "comment", "wordNormalized", "isActive", "qrUrl", "qrUrlExpiresAt" ], "type": "object" } } }, "description": "Actual control-plane projection; QR signatures expire after 900 seconds", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "scopes": [ "marketing:write" ] }, "evidence": { "fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/marketing.json", "implementationSha": "d72419fe1977a9f007e45254783a4a389711fb8c", "registrar": "registerMarketingPaths", "result": "accepted", "selection": "operations[operationId=updateMarketingLink]", "source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent" }, "operation": { "authAlternatives": [ { "hubApiKey": [] }, { "hubBearer": [] } ], "method": "patch", "operationId": "updateMarketingLink", "path": "/api/v1/tools/marketing/links", "requestSchemaRef": "#/components/schemas/MarketingLinkUpdateRequest", "requiredScopes": [ "marketing:write" ], "responseSchemaRefs": { "200": "#/components/schemas/MarketingLinkResponse", "400": "#/components/schemas/ProblemDetails", "401": "#/components/schemas/ProblemDetails", "403": "#/components/schemas/ProblemDetails", "404": "#/components/schemas/ProblemDetails", "409": "#/components/schemas/ProblemDetails", "413": "#/components/schemas/ProblemDetails", "422": "#/components/schemas/ProblemDetails", "429": "#/components/schemas/ProblemDetails", "500": "#/components/schemas/ProblemDetails" }, "successStatuses": [ 200 ], "title": "Authenticate with X-Api-Key or Authorization: Bearer tgf_* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code." } } ``` ## createMarketingCampaign `POST /api/v1/tools/marketing` — Authenticate with X-Api-Key or Authorization: Bearer tgf\_\* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code. Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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": "VALIDATION_ERROR or missing POST IDEMPOTENCY_KEY_REQUIRED", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "INVALID_API_KEY: absent, invalid, revoked or conflicting key headers; session JWT refused", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "INSUFFICIENT_SCOPE or resource/plan refusal", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "NOT_FOUND for a missing or foreign tenant sequence", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "CONFLICT for duplicate identity or in-flight idempotent command", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "PAYLOAD_TOO_LARGE or ITEM_COUNT_EXCEEDED", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "VALIDATION_ERROR for marketing domain input refusal or IDEMPOTENCY_KEY_MISMATCH for divergent retries", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "RATE_LIMIT_EXCEEDED or RATE_LIMIT_UNAVAILABLE", "headers": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } }, "500": { "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": "INTERNAL_ERROR without private implementation detail", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "headers": { "request": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ], "response": { "201": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "400": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "401": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "403": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "404": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "409": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "413": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "422": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "429": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "500": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "idempotency": { "boundary": null, "contract": { "mismatchStatus": 422, "required": true, "ttlSeconds": 86400 }, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ] }, "operationId": "createMarketingCampaign", "pagination": { "contract": null, "parameters": [] }, "request": { "body": { "content": { "application/json": { "schema": { "additionalProperties": false, "description": "Create an aggregate with its mandatory first source. Campaign target supports delivery_message, section_root or deeplink only; url/web_app belong to button_target. Code words are 4..100 characters, contain no whitespace and cannot be bot commands.", "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" }, "display_name": { "maxLength": 200, "minLength": 1, "type": "string" }, "first_link": { "oneOf": [ { "additionalProperties": false, "properties": { "comment": { "maxLength": 255, "type": [ "string", "null" ] }, "is_active": { "type": "boolean" }, "kind": { "enum": [ "link" ], "type": "string" }, "title": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "kind", "title" ], "type": "object" }, { "additionalProperties": false, "properties": { "code_word": { "maxLength": 100, "minLength": 4, "pattern": "^\\S+$", "type": "string" }, "comment": { "maxLength": 255, "type": [ "string", "null" ] }, "is_active": { "type": "boolean" }, "kind": { "enum": [ "code_word" ], "type": "string" }, "title": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "kind", "title", "code_word" ], "type": "object" } ] }, "is_active": { "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" } ] } }, "required": [ "display_name", "target", "first_link" ], "type": "object" } } }, "required": true }, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ] }, "response": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "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": { "type": [ "string", "null" ] }, "displayName": { "type": "string" }, "isActive": { "type": "boolean" }, "links": { "items": { "additionalProperties": false, "properties": { "campaignSeqNum": { "exclusiveMinimum": 0, "type": "integer" }, "comment": { "type": [ "string", "null" ] }, "isActive": { "type": "boolean" }, "kind": { "enum": [ "link", "code_word" ], "type": "string" }, "qrUrl": { "type": "string" }, "qrUrlExpiresAt": { "format": "date-time", "type": "string" }, "seqNum": { "exclusiveMinimum": 0, "type": "integer" }, "title": { "type": "string" }, "wordNormalized": { "type": [ "string", "null" ] } }, "required": [ "seqNum", "campaignSeqNum", "kind", "title", "comment", "wordNormalized", "isActive", "qrUrl", "qrUrlExpiresAt" ], "type": "object" }, "type": "array" }, "seqNum": { "exclusiveMinimum": 0, "type": "integer" }, "statAttributedClosedOrders": { "type": "number" }, "statAttributedOrders": { "type": "number" }, "statClosedOrders": { "type": "number" }, "statExistingUsersClicked": { "type": "number" }, "statNewUsersMonth": { "type": "number" }, "statNewUsersTotal": { "type": "number" }, "statTotalClicksMonth": { "type": "number" }, "statTotalClicksTotal": { "type": "number" }, "statTotalOrders": { "type": "number" }, "statTotalPayments": { "type": "number" }, "statUniqueClicksMonth": { "type": "number" }, "statUniqueClicksTotal": { "type": "number" }, "statUniqueOrders": { "type": "number" }, "statUpdatedAt": { "format": "date-time", "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" } ] } }, "required": [ "seqNum", "displayName", "target", "isActive", "buttonTitle", "buttonTarget", "statTotalClicksTotal", "statNewUsersTotal", "statUniqueClicksTotal", "statTotalClicksMonth", "statNewUsersMonth", "statUniqueClicksMonth", "statExistingUsersClicked", "statTotalOrders", "statTotalPayments", "statClosedOrders", "statUniqueOrders", "statAttributedOrders", "statAttributedClosedOrders", "statUpdatedAt", "links" ], "type": "object" } } }, "description": "Actual control-plane projection; QR signatures expire after 900 seconds", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "scopes": [ "marketing:write" ] }, "evidence": { "fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/marketing.json", "implementationSha": "d72419fe1977a9f007e45254783a4a389711fb8c", "registrar": "registerMarketingPaths", "result": "accepted", "selection": "operations[operationId=createMarketingCampaign]", "source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent" }, "operation": { "authAlternatives": [ { "hubApiKey": [] }, { "hubBearer": [] } ], "method": "post", "operationId": "createMarketingCampaign", "path": "/api/v1/tools/marketing", "requestSchemaRef": "#/components/schemas/MarketingCampaignCreateRequest", "requiredScopes": [ "marketing:write" ], "responseSchemaRefs": { "201": "#/components/schemas/MarketingCampaignResponse", "400": "#/components/schemas/ProblemDetails", "401": "#/components/schemas/ProblemDetails", "403": "#/components/schemas/ProblemDetails", "404": "#/components/schemas/ProblemDetails", "409": "#/components/schemas/ProblemDetails", "413": "#/components/schemas/ProblemDetails", "422": "#/components/schemas/ProblemDetails", "429": "#/components/schemas/ProblemDetails", "500": "#/components/schemas/ProblemDetails" }, "successStatuses": [ 201 ], "title": "Authenticate with X-Api-Key or Authorization: Bearer tgf_* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code." } } ``` ## deleteMarketingCampaign `POST /api/v1/tools/marketing/delete` — Authenticate with X-Api-Key or Authorization: Bearer tgf\_\* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code. Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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": "VALIDATION_ERROR or missing POST IDEMPOTENCY_KEY_REQUIRED", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "INVALID_API_KEY: absent, invalid, revoked or conflicting key headers; session JWT refused", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "INSUFFICIENT_SCOPE or resource/plan refusal", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "NOT_FOUND for a missing or foreign tenant sequence", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "CONFLICT for duplicate identity or in-flight idempotent command", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "PAYLOAD_TOO_LARGE or ITEM_COUNT_EXCEEDED", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "VALIDATION_ERROR for marketing domain input refusal or IDEMPOTENCY_KEY_MISMATCH for divergent retries", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "RATE_LIMIT_EXCEEDED or RATE_LIMIT_UNAVAILABLE", "headers": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } }, "500": { "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": "INTERNAL_ERROR without private implementation detail", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "headers": { "request": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ], "response": { "201": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "400": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "401": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "403": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "404": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "409": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "413": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "422": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "429": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "500": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "idempotency": { "boundary": null, "contract": { "mismatchStatus": 422, "required": true, "ttlSeconds": 86400 }, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ] }, "operationId": "deleteMarketingCampaign", "pagination": { "contract": null, "parameters": [] }, "request": { "body": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "seq_num": { "exclusiveMinimum": 0, "type": "integer" } }, "required": [ "seq_num" ], "type": "object" } } }, "required": true }, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ] }, "response": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "deleted": { "type": "boolean" }, "seqNum": { "exclusiveMinimum": 0, "type": "integer" } }, "required": [ "seqNum", "deleted" ], "type": "object" } } }, "description": "Actual control-plane projection; QR signatures expire after 900 seconds", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "scopes": [ "marketing:write" ] }, "evidence": { "fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/marketing.json", "implementationSha": "d72419fe1977a9f007e45254783a4a389711fb8c", "registrar": "registerMarketingPaths", "result": "accepted", "selection": "operations[operationId=deleteMarketingCampaign]", "source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent" }, "operation": { "authAlternatives": [ { "hubApiKey": [] }, { "hubBearer": [] } ], "method": "post", "operationId": "deleteMarketingCampaign", "path": "/api/v1/tools/marketing/delete", "requestSchemaRef": "#/components/schemas/MarketingDeleteRequest", "requiredScopes": [ "marketing:write" ], "responseSchemaRefs": { "201": "#/components/schemas/MarketingDeleteResponse", "400": "#/components/schemas/ProblemDetails", "401": "#/components/schemas/ProblemDetails", "403": "#/components/schemas/ProblemDetails", "404": "#/components/schemas/ProblemDetails", "409": "#/components/schemas/ProblemDetails", "413": "#/components/schemas/ProblemDetails", "422": "#/components/schemas/ProblemDetails", "429": "#/components/schemas/ProblemDetails", "500": "#/components/schemas/ProblemDetails" }, "successStatuses": [ 201 ], "title": "Authenticate with X-Api-Key or Authorization: Bearer tgf_* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code." } } ``` ## createMarketingLink `POST /api/v1/tools/marketing/links` — Authenticate with X-Api-Key or Authorization: Bearer tgf\_\* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code. Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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": "VALIDATION_ERROR or missing POST IDEMPOTENCY_KEY_REQUIRED", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "INVALID_API_KEY: absent, invalid, revoked or conflicting key headers; session JWT refused", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "INSUFFICIENT_SCOPE or resource/plan refusal", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "NOT_FOUND for a missing or foreign tenant sequence", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "CONFLICT for duplicate identity or in-flight idempotent command", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "PAYLOAD_TOO_LARGE or ITEM_COUNT_EXCEEDED", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "VALIDATION_ERROR for marketing domain input refusal or IDEMPOTENCY_KEY_MISMATCH for divergent retries", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "RATE_LIMIT_EXCEEDED or RATE_LIMIT_UNAVAILABLE", "headers": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } }, "500": { "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": "INTERNAL_ERROR without private implementation detail", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "headers": { "request": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ], "response": { "201": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "400": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "401": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "403": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "404": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "409": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "413": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "422": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "429": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "500": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "idempotency": { "boundary": null, "contract": { "mismatchStatus": 422, "required": true, "ttlSeconds": 86400 }, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ] }, "operationId": "createMarketingLink", "pagination": { "contract": null, "parameters": [] }, "request": { "body": { "content": { "application/json": { "schema": { "description": "Create a source under campaign_seq_num. code_word is required only for kind=code_word; 4..100 characters, no whitespace or bot commands. The domain also rejects reserved locale-specific words.", "oneOf": [ { "additionalProperties": false, "properties": { "campaign_seq_num": { "exclusiveMinimum": 0, "type": "integer" }, "comment": { "maxLength": 255, "type": [ "string", "null" ] }, "is_active": { "type": "boolean" }, "kind": { "enum": [ "link" ], "type": "string" }, "title": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "campaign_seq_num", "kind", "title" ], "type": "object" }, { "additionalProperties": false, "properties": { "campaign_seq_num": { "exclusiveMinimum": 0, "type": "integer" }, "code_word": { "maxLength": 100, "minLength": 4, "pattern": "^\\S+$", "type": "string" }, "comment": { "maxLength": 255, "type": [ "string", "null" ] }, "is_active": { "type": "boolean" }, "kind": { "enum": [ "code_word" ], "type": "string" }, "title": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "campaign_seq_num", "kind", "title", "code_word" ], "type": "object" } ] } } }, "required": true }, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ] }, "response": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "campaignSeqNum": { "exclusiveMinimum": 0, "type": "integer" }, "comment": { "type": [ "string", "null" ] }, "isActive": { "type": "boolean" }, "kind": { "enum": [ "link", "code_word" ], "type": "string" }, "qrUrl": { "type": "string" }, "qrUrlExpiresAt": { "format": "date-time", "type": "string" }, "seqNum": { "exclusiveMinimum": 0, "type": "integer" }, "title": { "type": "string" }, "wordNormalized": { "type": [ "string", "null" ] } }, "required": [ "seqNum", "campaignSeqNum", "kind", "title", "comment", "wordNormalized", "isActive", "qrUrl", "qrUrlExpiresAt" ], "type": "object" } } }, "description": "Actual control-plane projection; QR signatures expire after 900 seconds", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "scopes": [ "marketing:write" ] }, "evidence": { "fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/marketing.json", "implementationSha": "d72419fe1977a9f007e45254783a4a389711fb8c", "registrar": "registerMarketingPaths", "result": "accepted", "selection": "operations[operationId=createMarketingLink]", "source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent" }, "operation": { "authAlternatives": [ { "hubApiKey": [] }, { "hubBearer": [] } ], "method": "post", "operationId": "createMarketingLink", "path": "/api/v1/tools/marketing/links", "requestSchemaRef": "#/components/schemas/MarketingLinkCreateRequest", "requiredScopes": [ "marketing:write" ], "responseSchemaRefs": { "201": "#/components/schemas/MarketingLinkResponse", "400": "#/components/schemas/ProblemDetails", "401": "#/components/schemas/ProblemDetails", "403": "#/components/schemas/ProblemDetails", "404": "#/components/schemas/ProblemDetails", "409": "#/components/schemas/ProblemDetails", "413": "#/components/schemas/ProblemDetails", "422": "#/components/schemas/ProblemDetails", "429": "#/components/schemas/ProblemDetails", "500": "#/components/schemas/ProblemDetails" }, "successStatuses": [ 201 ], "title": "Authenticate with X-Api-Key or Authorization: Bearer tgf_* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code." } } ``` ## deleteMarketingLink `POST /api/v1/tools/marketing/links/delete` — Authenticate with X-Api-Key or Authorization: Bearer tgf\_\* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code. Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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": "VALIDATION_ERROR or missing POST IDEMPOTENCY_KEY_REQUIRED", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "INVALID_API_KEY: absent, invalid, revoked or conflicting key headers; session JWT refused", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "INSUFFICIENT_SCOPE or resource/plan refusal", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "NOT_FOUND for a missing or foreign tenant sequence", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "CONFLICT for duplicate identity or in-flight idempotent command", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "PAYLOAD_TOO_LARGE or ITEM_COUNT_EXCEEDED", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "VALIDATION_ERROR for marketing domain input refusal or IDEMPOTENCY_KEY_MISMATCH for divergent retries", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as 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": "RATE_LIMIT_EXCEEDED or RATE_LIMIT_UNAVAILABLE", "headers": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } }, "500": { "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": "INTERNAL_ERROR without private implementation detail", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "headers": { "request": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ], "response": { "201": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "400": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "401": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "403": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "404": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "409": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "413": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "422": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "429": { "Retry-After": { "description": "Retry delay in seconds, when supplied by limiter", "schema": { "type": "string" } }, "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } }, "500": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "idempotency": { "boundary": null, "contract": { "mismatchStatus": 422, "required": true, "ttlSeconds": 86400 }, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ] }, "operationId": "deleteMarketingLink", "pagination": { "contract": null, "parameters": [] }, "request": { "body": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "seq_num": { "exclusiveMinimum": 0, "type": "integer" } }, "required": [ "seq_num" ], "type": "object" } } }, "required": true }, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ] }, "response": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "deleted": { "type": "boolean" }, "seqNum": { "exclusiveMinimum": 0, "type": "integer" } }, "required": [ "seqNum", "deleted" ], "type": "object" } } }, "description": "Actual control-plane projection; QR signatures expire after 900 seconds", "headers": { "X-Bot-Username": { "description": "Public active bot handle, when configured", "schema": { "type": "string" } }, "X-Client-Slug": { "description": "Authenticated active tenant slug", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Effective requests-per-minute budget", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Remaining budget or unknown", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Reset as Unix seconds", "schema": { "type": "string" } } } } }, "scopes": [ "marketing:write" ] }, "evidence": { "fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/marketing.json", "implementationSha": "d72419fe1977a9f007e45254783a4a389711fb8c", "registrar": "registerMarketingPaths", "result": "accepted", "selection": "operations[operationId=deleteMarketingLink]", "source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent" }, "operation": { "authAlternatives": [ { "hubApiKey": [] }, { "hubBearer": [] } ], "method": "post", "operationId": "deleteMarketingLink", "path": "/api/v1/tools/marketing/links/delete", "requestSchemaRef": "#/components/schemas/MarketingDeleteRequest", "requiredScopes": [ "marketing:write" ], "responseSchemaRefs": { "201": "#/components/schemas/MarketingDeleteResponse", "400": "#/components/schemas/ProblemDetails", "401": "#/components/schemas/ProblemDetails", "403": "#/components/schemas/ProblemDetails", "404": "#/components/schemas/ProblemDetails", "409": "#/components/schemas/ProblemDetails", "413": "#/components/schemas/ProblemDetails", "422": "#/components/schemas/ProblemDetails", "429": "#/components/schemas/ProblemDetails", "500": "#/components/schemas/ProblemDetails" }, "successStatuses": [ 201 ], "title": "Authenticate with X-Api-Key or Authorization: Bearer tgf_* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code." } } ```