Media

Add several images or videos from links

Up to 20 links; each answers with its media_id or its own error.

POSThttps://traceeai.com/api/v1/media/from-urls

CLI:tracee media add-many·MCP:mediaaction add

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
  • urlsstring[]required

    Several images or videos at once; each gets its own media_id or error

    1–20 itemseach uri

  • alt_textstring

    The alt text

    up to 1,000 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.