---
title: "Delete an item (unpublishes first; removes images and models)"
method: DELETE
path: "/v1/items/{id}"
tags: ["items"]
---

# Delete an item (unpublishes first; removes images and models)

`DELETE /v1/items/{id}`

## Request

- Base URL: `https://pixeloa.ai`
- URL: `https://pixeloa.ai/v1/items/{id}`
- Auth: HTTP bearer

Permanent. A published item is unpublished first so its AR page and embeds go quiet, then its images, models and QR are removed. Requires the same scope as creating items.

## Path parameters

- `id` string, uuid, required

## Response `200`

OK

- Item
  - `id` string, uuid
  - `title` string
  - `description` string, nullable
  - `status` 'draft' | 'analyzing' | 'awaiting_confirmation' | 'confirmed' | 'generating' | 'ready' | 'failed'
  - `visibility` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time, nullable
  - `dimensions_cm` object
    - `confirmed` object, nullable
    - `estimated` object, nullable
  - `model` object
    - `available` boolean
    - `sha256` string, nullable
  - `public` object
    - `published` boolean
    - `slug` string, nullable
    - `ar_url` string, uri, nullable
    - `embed_url` string, uri, nullable
  - `publishable` object: Row-level pre-check for POST /publish; POST /publish reports the exact resolver state on 409.
    - `ok` boolean
    - `blockers` string[]
  - `next_allowed_actions` string[]

## Other responses

- `401`: Error envelope
- `403`: Error envelope
- `404`: Error envelope
- `409`: Error envelope
- `422`: Error envelope
- `429`: Error envelope

---

[API](https://skmtc.dev/pixeloa/apis/pixeloa-api.md) · [All operations](https://skmtc.dev/pixeloa/apis/pixeloa-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pixeloa/apis/pixeloa-api/revisions/10a8178bed64?raw)