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

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

deleteCatalogItem

Обновлено

DELETE /api/v1/catalog/{seq_id}

deleteCatalogItem

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

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.description"Optional: a sent key makes a retry replay the first answer from the 24-hour global cache."
0.in"header"
0.name"Idempotency-Key"
0.requiredfalse
0.schema0.schema
1.in"path"
1.name"seq_id"
1.requiredtrue
1.schema1.schema

Тело запроса

ПолеЗначение
Тело запросаnull

Ответы

ПолеЗначение
200.content.application/json.schemaCatalogDeleteResult
200.description"Catalog item deleted (or already deleted)"

Ошибки

ПолеЗначение
400.content.application/problem+json.schemaProblemDetails
400.description"Catalog sequence does not match the request schema"
401.content.application/problem+json.schemaProblemDetails
401.description"Missing or invalid API key"
403.content.application/problem+json.schemaProblemDetails
403.description"Catalog write scope or resource policy refused the request"
404.content.application/problem+json.schemaProblemDetails
404.description"Catalog item was not found for the authenticated tenant"
409.content.application/problem+json.schemaProblemDetails
409.description"CONFLICT: a request under the same Idempotency-Key is still processing"
422.content.application/problem+json.schemaProblemDetails
422.description"IDEMPOTENCY_KEY_MISMATCH: the Idempotency-Key was already used for a different request"

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

ПолеЗначение
description"Soft delete: the item leaves the showcase, storefront and listings and can no longer be bought; existing orders keep their own item snapshot. A repeat answers deleted:true again. Undo with content publish intent RESTORE; to pause sales only, PATCH is_active:false. Requires an API key credential, supplied in X-Api-Key or Authorization: Bearer tgf_*."
operationId"deleteCatalogItem"
tags["catalog"]
x-idempotency"http-cache"