TraceeDocs

Media

Add media from a link

Copies an image from a public https link into the library, converted to a format every network takes. Videos stay links.

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

CLI:tracee media from-url·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
  • urlstringrequired

    A public https link to an image or video.

    uriup to 2,000 characters

  • altTextstring

    up to 1,000 characters

  • namestring

    up to 200 characters

Response

Errors
  • 201The stored media.Media
    • idstringrequired

      uuid

    • urlstringrequired

      Public link to the file, for attaching and previewing.

      uri

    • kindstringrequired

      Available options:imagevideo

    • mimeTypestringrequired
    • bytesinteger | nullrequired
    • namestring | nullrequired
    • altTextstring | nullrequired
    • createdAtstringrequired

      date-time