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

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

updateQuickReply

Обновлено

PATCH /api/v1/tools/quick-replies

Update an operator quick reply by tenant sequence

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

Scopes: ALL. Auth alternatives: OR; scopes внутри альтернативы: ALL.

ПолеЗначение
security.0.hubApiKey[]
security.1.hubBearer[]
securitySchemes.hubApiKey.in"header"
securitySchemes.hubApiKey.name"X-Api-Key"
securitySchemes.hubApiKey.type"apiKey"
securitySchemes.hubBearer.scheme"bearer"
securitySchemes.hubBearer.type"http"
x-required-scopes["quick-replies:write"]

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

ПолеЗначение
0.description"Replay the same tenant, credential, route and request for 24 hours."
0.in"header"
0.name"Idempotency-Key"
0.requiredfalse
0.schema0.schema

Тело запроса

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

Ответы

ПолеЗначение
200.content.application/json.schemaQuickReplyResponse
200.description"Updated quick reply."
200.headers.X-Bot-Username.schema200.headers.X-Bot-Username.schema
200.headers.X-Client-Slug.schema200.headers.X-Client-Slug.schema
200.headers.X-RateLimit-Limit.schema200.headers.X-RateLimit-Limit.schema
200.headers.X-RateLimit-Remaining.schema200.headers.X-RateLimit-Remaining.schema
200.headers.X-RateLimit-Reset.schema200.headers.X-RateLimit-Reset.schema

Ошибки

ПолеЗначение
400.content.application/problem+json.schemaProblemDetails
400.description"Strict request validation failed."
400.x-error-codes["VALIDATION_ERROR"]
401.content.application/problem+json.schemaProblemDetails
401.description"Missing, invalid, revoked or expired API credential. A surface-session JWT is not accepted."
401.x-error-codes["INVALID_API_KEY"]
403.content.application/problem+json.schemaProblemDetails
403.description"Missing effective scope, forbidden publishable key, inaccessible resource or no active bot."
403.x-error-codes["INSUFFICIENT_SCOPE","PUBLISHABLE_KEY_NOT_ALLOWED","FORBIDDEN","NO_ACTIVE_BOT"]
404.content.application/problem+json.schemaProblemDetails
404.description"No quick reply with this sequence in the authenticated tenant."
404.x-error-codes["NOT_FOUND"]
409.content.application/problem+json.schemaProblemDetails
409.description"Another request with this key is still processing."
409.x-error-codes["CONFLICT"]
413.content.application/problem+json.schemaProblemDetails
413.description"The per-tool payload size or item-count limit was exceeded before request validation."
413.x-error-codes["PAYLOAD_TOO_LARGE","ITEM_COUNT_EXCEEDED"]
422.content.application/problem+json.schemaProblemDetails
422.description"Idempotency-Key was reused with different request inputs."
422.x-error-codes["IDEMPOTENCY_KEY_MISMATCH"]
429.content.application/problem+json.schemaProblemDetails
429.description"The per-tool rate limit was exceeded or its subsystem is unavailable (fail closed)."
429.headers.Retry-After.description"Seconds before retrying the per-tool resource policy."
429.headers.Retry-After.requiredfalse
429.headers.Retry-After.schema429.headers.Retry-After.schema
429.x-error-codes["RATE_LIMIT_EXCEEDED","RATE_LIMIT_UNAVAILABLE"]
500.content.application/problem+json.schemaProblemDetails
500.description"Unexpected internal failure."
500.x-error-codes["INTERNAL_ERROR"]

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

ПолеЗначение
description"seq_num is a numeric positive int4 (1–2147483647). Editable fields are optional; an empty patch is accepted. Idempotency-Key is optional on PATCH. No If-Match or ETag contract."
operationId"updateQuickReply"
summary"Update an operator quick reply by tenant sequence"
tags["quick-replies"]
x-idempotency.mismatchStatus422
x-idempotency.requiredfalse
x-idempotency.ttlSeconds86400
x-pagination.kind"none"