traceeai.com Support Get a key

Media

Rename a file or set its alt text

PATCHhttps://traceeai.com/api/v1/media/{media_id}

CLI:tracee media describe·MCP:mediaaction describe

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
The file to change. From GET /api/v1/media/library (or the media_id POST /api/v1/media/from-url / generate_image returns)
uuid

Body

application/json

namestring
The file's new name
up to 120 characters
alt_textstring
The alt text
up to 1,000 characters

Response

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.

Rename a file or set its alt text

curl -X PATCH "https://traceeai.com/api/v1/media/$MEDIA_ID" \
  -H "Authorization: Bearer $TRACEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Launch week"
  }'

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