Skip to main content
DELETE
/
api
/
albums
/
{album_id}
/
assets
Remove assets from an album
curl --request DELETE \
  --url https://api.example.com/api/albums/{album_id}/assets \
  --header 'Content-Type: application/json' \
  --data '
{
  "asset_ids": [
    "<string>"
  ]
}
'
{}

Path Parameters

​
album_id
string
required

Album ID (with album_ prefix) of the album to detach assets from.

Body

application/json
​
asset_ids
string[]
required

Asset IDs (with asset_ prefix) to associate with the album. Get IDs from list_assets, search_assets, or list_album_assets. Up to 100 ids per request.

Maximum array length: 100

Response

Successful Response

Acknowledgment body returned by destructive endpoints (delete / trash / restore / permanently delete / remove-from-album / empty-trash).

Carries no fields — the HTTP 200 + empty JSON object is itself the success signal. Exists so MCP tools generated from these endpoints have a real outputSchema (rather than the null schema FastMCP emits for 204 responses), which ChatGPT's MCP submission tooling requires.