# Statuses

> What a release and each of its stores can be, as the API answers. status keeps the old release word for one deprecation cycle.

<!-- Generated from openapi/hills-v1.json by scripts/api-reference.mjs. Edit the operation in hills-music (server/lib/ops), not this page. -->

Approval delivers at once; a store shows live when it is.

## release_status

| Code | Meaning |
| --- | --- |
| `draft` | Draft: Not submitted yet. |
| `in_review` | In review: Submitted; waiting for a review decision. |
| `changes_requested` | Changes requested: Sent back to the artist with a reason; editable again. |
| `approved` | Approved: Approved: its stores are delivered right away. |
| `archived` | Archived: Archived: not delivered. |
| `taken_down` | Taken down: Taken down from every store it was in. |

## delivery_state

| Code | Meaning |
| --- | --- |
| `not_started` | Not started: No store has been sent anything yet. |
| `delivering` | Delivering: Its stores are being sent the release. |
| `delivered` | Delivered — going live soon: Every store has it; none shows it live yet. |
| `partially_live` | Live in some stores: Live in some stores; the others have it or are getting it. |
| `live` | Live: Live in every store it went to. |
| `needs_attention` | Delayed: A store failed, rejected it, or waits for a person. |
| `taking_down` | Taking down: A takedown is on its way to its stores. |
| `taken_down` | Taken down: Taken down from every store it was in. |

## update_state

| Code | Meaning |
| --- | --- |
| `none` | Every store has the latest approved version. |
| `pending` | A newer approved version waits to be sent. |
| `delivering` | A newer approved version is being sent. |

## stores[key].status

| Code | Meaning |
| --- | --- |
| `skipped` | Not available (phase off) |
| `blocked` | On hold (phase queue) |
| `awaiting_approval` | Waiting for approval (phase review) |
| `queued` | Queued (phase queue) |
| `retry_wait` | Sending (phase queue) |
| `packaging` | Preparing (phase packing) |
| `uploading` | Sending (phase sending) |
| `manifest_sent` | Sending (phase sending) |
| `requested_via_ci` | Delivered — going live soon (phase done) |
| `delivered` | Delivered — going live soon (phase done) |
| `acknowledged` | Delivered — going live soon (phase done) |
| `live` | Live (phase done) |
| `rejected_by_store` | Delayed (phase attention) |
| `failed` | Delayed (phase attention) |
| `cancelled` | Not sent (phase off) |
| `manual_required` | In progress (phase attention) |
| `takedown_queued` | Takedown requested (phase takedown) |
| `takedown_sending` | Taking down (phase takedown) |
| `takedown_sent` | Taking down (phase takedown) |
| `taken_down` | Taken down (phase takedown) |

## status (deprecated, removed on 2027-04-30)

| Code | Meaning |
| --- | --- |
| `draft` | release_status draft |
| `pending` | release_status in_review |
| `approved` | release_status approved, not live in any store yet |
| `distributed` | release_status approved, live in at least one store |
| `rejected` | release_status changes_requested |
| `archived` | release_status archived or taken_down |

Source: https://developer.hillsmusic.com/reference/statuses/