# patchCatalogItem

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

# patchCatalogItem

`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](https://telegafirst.com/docs/schema-1530eae3d9b69eb0d4bf2268a4cc47372fcec06f1cf1736785dd6f16848382fc) |
| 1.in | "query" |
| 1.name | "zone" |
| 1.required | false |
| 1.schema | [1.schema](https://telegafirst.com/docs/schema-2246bd83a37c095649d15bd15c3c28d651ca21782dc7be76ca0f8ae36d9c639b) |
| 2.in | "header" |
| 2.name | "If-Match" |
| 2.required | true |
| 2.schema | [2.schema](https://telegafirst.com/docs/schema-9ac136edb99a2063b3091602181c8d2022fdccb5b514991319d58544c2e57e95) |
| 3.in | "header" |
| 3.name | "Idempotency-Key" |
| 3.required | true |
| 3.schema | [3.schema](https://telegafirst.com/docs/schema-29ec966ad6b37d138ce2bb9a66d3242c99e3e644bdc66b199a9e593f801851d5) |

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

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

## Ответы

| Поле | Значение |
| - | - |
| 200.content.application/json.schema | [CatalogDetail](https://telegafirst.com/docs/schema-52168ee186562a7ae09896ec1fbb2900b51f3d2d9535f05215452c17981a9373) |
| 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](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |

## Ошибки

| Поле | Значение |
| - | - |
| 400.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 400.description | "Idempotency-Key must contain between 1 and 128 characters" |
| 401.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 401.description | "Missing or invalid API key" |
| 403.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 403.description | "Catalog write scope or resource policy refused the request" |
| 404.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 404.description | "Catalog item was not found for the authenticated tenant" |
| 409.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 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](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 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](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 422.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 422.description | "Catalog patch is invalid or contains a read-only field" |
| 428.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 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" |