TraceeDocs

Media

Import files from a connected app

Brings pictures and videos (Canva designs and Figma frames as PNG) into the media library like an upload; each file's media_ids attach to posts. A file imported before isn't copied again.

POSThttps://traceeai.com/api/v1/media/apps/{app}/import

CLI:tracee media import-from-app·MCP:mediaaction import_from_app

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

  • appstringrequired

    The connected app

    Available options:googledrivedropboxone_driveboxcanvafigmagoogledocsnotionconfluence

Body

application/json
  • file_idsstring[]required

    Ids from browse_app_files. From GET /api/v1/media/apps/{app}/files (items[].id)

    1–20 itemseach 1–500 characters

Response

Errors
  • 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.