Документация / Как начать / Работа с MCP / Идентификаторы и страницы результатов / REST: catalog / patchCatalogItem Для AI-агентов: markdown этой страницы — /docs/api-op-patchcatalogitem.md · индекс документации — /llms.txt
patchCatalogItem Обновлено 4 октября 2026 г.
PATCH /api/v1/catalog/{seq_id}
patchCatalogItem
# Авторизация и права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 ["catalog:write"]
# Параметры запросаПоле Значение 0.in "path" 0.name "seq_id" 0.required true 0.schema 0.schema 1.in "query" 1.name "zone" 1.required false 1.schema 1.schema 2.in "header" 2.name "If-Match" 2.required true 2.schema 2.schema 3.in "header" 3.name "Idempotency-Key" 3.required true 3.schema 3.schema
# Тело запросаПоле Значение content.application/json.schema CatalogPatch required true
# ОтветыПоле Значение 200.content.application/json.schema CatalogDetail 200.description "Patch catalog item" 200.headers.ETag.description "Weak ETag for the current catalog item representation" 200.headers.ETag.required true 200.headers.ETag.schema 200.headers.ETag.schema
# ОшибкиПоле Значение 400.content.application/problem+json.schema ProblemDetails 400.description "Idempotency-Key must contain between 1 and 128 characters" 401.content.application/problem+json.schema ProblemDetails 401.description "Missing or invalid API key" 403.content.application/problem+json.schema ProblemDetails 403.description "Catalog write scope or resource policy refused the request" 404.content.application/problem+json.schema ProblemDetails 404.description "Catalog item was not found for the authenticated tenant" 409.content.application/problem+json.schema ProblemDetails 409.description "Catalog command with this identity is already in progress, or the patch attempts to rename, remove, or reuse a durable variant key" 412.content.application/problem+json.schema ProblemDetails 412.description "If-Match does not match the current catalog item ETag; the Problem Details current_etag extension and ETag response header identify the winning version" 412.headers.ETag.description "Weak ETag for the current catalog item representation" 412.headers.ETag.required true 412.headers.ETag.schema 412.headers.ETag.schema 422.content.application/problem+json.schema ProblemDetails 422.description "Catalog patch is invalid or contains a read-only field" 428.content.application/problem+json.schema ProblemDetails 428.description "If-Match and Idempotency-Key headers are required"
# Дополнительные условияПоле Значение description "Requires an API key credential, supplied in X-Api-Key or Authorization: Bearer tgf_*. Surface-session JWT credentials are not accepted for this operation." operationId "patchCatalogItem" tags ["catalog"] x-idempotency "durable-receipt"