Media

Upload a file

Uploads a JPG, PNG, GIF or WebP photo (up to 15 MB) or an MP4, MOV or WebM video (up to 100 MB). Send multipart/form-data with the file in a field named file, or the raw file as the body with its own Content-Type.

POSThttps://traceeai.com/api/v1/media

CLI:tracee media upload

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

multipart/form-data, or the raw file

filefilerequired
altTextstring
up to 1,000 characters

Response

Errors

201The stored file.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