Listings

Soft-delete a listing

Soft delete. The listing is hidden from the sale page, the dashboard, and every status-filtered read, but the document and its photos survive for 7 days and can be recovered with POST /api/items/{id}/restore. A purge job hard-deletes the document and its Storage blobs once the window closes, after which restore returns 410. Repeating the delete is a no-op success, not a 404.

delete/api/items/{id}

Request

  • Base URL: https://clearlist.me
  • URL: https://clearlist.me/api/items/{id}
  • Auth: one of:
    • API key in header X-ClearList-API-Key
    • OAuth 2 (authorization code, authorization URL https://clearlist.me/oauth/authorize, token URL https://clearlist.me/api/oauth/token, scopes: write)

Response

Deleted, or already deleted.

successboolean

Changes

No recorded changes to this operation across all 1 revision of this API.