REST API ReferenceEndpointsFiles

List files

List files in your account. By default this returns your 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 — both require the Production API add-on. Files are returned most recently updated first. Cursor-paginated; see the [Pagination](/pagination) guide.

Authentication

AuthorizationBearer
API key from [app.videogen.io/api](https://app.videogen.io/api). The full key is only shown once when you create it.

Query parameters

limitintegerOptional1-200Defaults to 50

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

cursorstringOptional

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.

includeExportFilesbooleanOptionalDefaults to false

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. Requires the Production API add-on; returns an error if you set it to true without it.

includeProjectFilesbooleanOptionalDefaults to false

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. Requires the Production API add-on; returns an error if you set it to true without it.

Response

File list
fileslist of objects
hasMoreboolean

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

nextCursorstring or null

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