---
title: "Bulk retire items."
method: POST
path: "/authoring/v1/changes/status/retire"
tags: ["Authoring changes"]
---

# Bulk retire items.

`POST /authoring/v1/changes/status/retire`

Use the `/changes/status/retire` endpoint to change the status of multiple items to the retired state. Currently, only Assets and Content support workflow states. For examples of request, see the documentation for `changes/status/ready` endpoint.
<br />User roles: admin, manager, editor

## Request body

- object
  - `ids` object[]
    - `id` string
    - `classification` 'asset' | 'content' — The classification of the item. Only Assets and Content currently have workflow status.
    - `rev` string

## Response `200`

See the status field to determine whether the request was successful.

- object
  - `status` 'success' | 'partial' | 'failure' — Represents the success of the request.
  - `missing` string[] — These are dependencies of items that were requested. The operation should be repeated with these items also included. The format of the ids is the `uid` format with the classification and id combined.
  - `genericErrors` string[] — These are items that failed for system are not actionable directly by the API user. They may indicate system errors and also dependent errors i.e. where the item failed because its dependency failed. The format of the ids is the `uid` format with the classification and id combined.
  - `userErrors` string[] — These are items that failed for breaking various rules that make the operation valid. These are the actionable errors. The format of the ids is the `uid` format with the classification and id combined.
  - `successful` string[] — Even when there are failures some items can succeed, this is the list of ids that succeeded. The format of the ids is the `uid` format with the classification and id combined.
  - `messages` object

## Other responses

- `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time.
- `503` — The service is currently unavailable. Try again later.
- `default` — Unexpected error.

---

[API](https://skmtc.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/revisions/677305266d89/schema)