---
title: "Retire an item with the specified unique ID."
method: POST
path: "/authoring/v1/changes/{uid}/status/retire"
tags: ["Authoring changes"]
---

# Retire an item with the specified unique ID.

`POST /authoring/v1/changes/{uid}/status/retire`

Use the `/changes/{uid}/status/retire` endpoint to retire a single item with the specified unique ID. The unique ID (uid) is the items classification and the ID combined to create an ID that is unique across all content hub items.
If the item has draft dependencies then you must use the Bulk retire API to retire the group of dependent items.
Currently, only Assets and Content support workflow.
<br />User roles: admin, manager, editor

## Path parameters

- `uid` string, required

## Query parameters

- `rev` string

## Response `200`

Item was successfully retired. The item is returned in the response body.

## Other responses

- `400` — Unable to retire the specified item in its current state or the request made was invalid.
- `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)