---
title: "Delete an asset"
method: DELETE
path: "/api/v1/assets/{assetId}"
tags: ["Assets"]
---

# Delete an asset

`DELETE /api/v1/assets/{assetId}`

## Request

- Base URL: `https://api.popnow.ai`
- URL: `https://api.popnow.ai/api/v1/assets/{assetId}`
- Auth: HTTP bearer

The asset disappears immediately (it is also removed from every
collection) and its `uri` stops working in new requests; the stored file
is then deleted. Deleting an unknown or
already deleted asset, or one in a library this key does not reach,
returns the same result, so retries are safe and no Idempotency-Key is
needed. Deleting does not reset the daily limit on new assets. In a team
library, billing and readonly members cannot delete, and developers can
delete only assets they saved (403, `data.reason`
`asset_permission_denied`).

## Response `200`

Deleted.

- AssetDeletedEnvelope
  - `code` 200, required
  - `msg` 'success', required
  - `request_id` string, required: Correlation identifier. Include it in support requests.
  - `data` object, required
    - `id` string, required
    - `deleted` true, required

## Other responses

- `401`: Missing, malformed, expired, revoked, or otherwise invalid API key.
- `403`: Account, model, API-key, IP, or region authorization failed.
- `429`: Account-level request limit exceeded.
- `500`: Internal failure. Details are not exposed; report `request_id` to support.

## Changes

- **2026-10-20** `fede911a6e9b`: 48 warning
  - added the new `agent_project_budget` enum value to the `allOf[subschema #2]/data/reason` response property for the response status `401`
  - added the new `agent_project_budget` enum value to the `allOf[subschema #2]/data/reason` response property for the response status `403`
  - added the new `agent_project_budget` enum value to the `allOf[subschema #2]/data/reason` response property for the response status `429`
  - added the new `agent_project_budget` enum value to the `allOf[subschema #2]/data/reason` response property for the response status `500`
  - …44 more

[Operation history](https://skmtc.dev/popnow/apis/popnow-api/changes/api/v1/assets/:assetId/delete.md)

---

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