Sign in
Files

List files

List files accessible to your team. By default this returns standalone files (direct tool-call outputs and uploads) and omits two categories: export files (the raw output files of your exports) and project files (the generative files created within a project, e.g. each AI image and text-to-speech file in a script-to-video workflow output). Set includeExportFiles and/or includeProjectFiles to true to include them. Use selfOnly=true to restrict results to files created by the calling API key's user. Files are returned most recently updated first. Cursor-paginated; see the Pagination guide.

get/v1/files

Query parameters

limitinteger

Maximum number of items to return in the page. Defaults to 50; capped at 200. See Pagination.

cursorstring

Opaque pagination cursor returned as nextCursor by the previous page. Omit on the first request. Cursors are tied to the endpoint that produced them and must be passed unmodified. See Pagination.

selfOnlyboolean

When true, returns only items created by the API key's owner. When false (default), returns all items accessible to the team.

includeExportFilesboolean

When true, includes export files: the raw output files of your exports (the rendered MP4 you download from an export). When false (default), they are omitted.

includeProjectFilesboolean

When true, includes project files: the generative files created within a project (e.g. each AI image and text-to-speech file produced inside a script-to-video workflow output). When false (default), they are omitted.

Response

File list

hasMoreboolean required

When true, there are more files available. Pass nextCursor as the cursor query param to fetch the next page.

nextCursorstring nullable required

Opaque cursor to fetch the next page. null when hasMore is false.

Changes