Brand

Take an asset out of the brand

The file stays in the media library.

DELhttps://traceeai.com/api/v1/brand/assets/{media_id}

CLI:tracee brand assets remove·MCP:brandaction remove_asset

Authorizations

Authorizationstringheaderrequired
Bearer <key>: a personal key (tracee login or Settings → Personal keys), a workspace key, or an MCP client's OAuth token. See Authentication.

Headers

Tracee-Workspacestring
For a personal key or OAuth token that reaches several workspaces: the workspace id to act on. Workspace keys don't need it.
uuid

Path parameters

media_idstringrequired
From GET /api/v1/media/library (or the media_id POST /api/v1/media/from-url / generate_image returns).
uuid

Response

Errors

200Done.
The action's result, exactly as the MCP tool returns it to agents. A next field, when present, names the endpoint that follows up.

Take an asset out of the brand

curl -X DELETE "https://traceeai.com/api/v1/brand/assets/$MEDIA_ID" \
  -H "Authorization: Bearer $TRACEE_API_KEY"

{
  "removed_from_brand": {
    "media_id": "d838221a-0599-4005-ae64-ca118a8187cf",
    "url": "https://cdn.test/logo.png",
    "kind": "image",
    "role": null,
    "name": "logo.png",
    "alt_text": "Our logo"
  },
  "note": "Still in the media library."
}