Безвозвратное удаление архивного товара

Безвозвратно удаляет товар. Операция доступна только для товаров в статусе ARCHIVED — для остальных возвращается ошибка 400. Восстановить товар после удаления невозможно.

В отличие от удаления, архивация (POST /v1/variants/{id}/archive) переводит товар в статус ARCHIVED и делает его недоступным для покупки, но данные сохраняются: товар остается в списке GET /v1/variants с фильтром status=ARCHIVED и его можно вернуть с помощью запроса POST /v1/variants/{id}/unarchive.

Чтобы удалить активный товар, сначала переведите его в архив. Не удаляйте товар сразу после архивации, если он был опубликован и мог участвовать в заказах: безвозвратное удаление ухудшит клиентский опыт, например в истории заказов. Безвозвратно удаляйте только те архивные товары, которые точно больше не понадобятся.

Request

DELETE

https://api.kit.yandex.net/v1/variants/{id}

Responses

204 No Content

Товар безвозвратно удален

400 Bad Request

Некорректный запрос.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

401 Unauthorized

Не авторизован.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

404 Not Found

Ресурс не найден.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

500 Internal Server Error

Внутренняя ошибка сервера.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000