TraceeDocs

Media

Browse a connected app's files

Folders, pictures, videos and docs in a connected Google Drive, Dropbox, OneDrive, Box, Canva, Figma, Google Docs, Notion or Confluence. Without folder_id: the top folder; query searches by name. Figma: pass a file link as folder_id.

GEThttps://traceeai.com/api/v1/media/apps/{app}/files

CLI:tracee media app-files·MCP:mediaaction browse_app_files

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

Query parameters

  • folder_idstring

    A folder's id from an earlier browse (figma: a file link). From GET /api/v1/media/apps/{app}/files (an item with kind=folder)

    up to 500 characters

  • querystring

    up to 100 characters

  • cursorstring

    Next_cursor from the last page

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