traceeai.com Support Get a key

Brand

Add a brand asset

Adds a public https image or video to the library as a brand asset with a role (logo, product, people, social, other).

POSThttps://traceeai.com/api/v1/brand/assets

CLI:tracee brand assets add·MCP:brandaction add_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

Body

application/json

urlstringrequired
A public https image or video
up to 1,000 characters
rolestringrequired
Available options:logoproductpeoplesocialother
namestring
up to 200 characters
alt_textstring
up to 500 characters

Response

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

Add a brand asset

curl -X POST "https://traceeai.com/api/v1/brand/assets" \
  -H "Authorization: Bearer $TRACEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://acme.com/logo.png",
    "role": "logo",
    "name": "Acme logo"
  }'

{
  "…": "The action's result, as the MCP tool returns it"
}