DocsAPI referenceFiles

List files

The account's uploads and outputs that still exist, newest first, a page at a time: pass next_cursor as cursor for the next page, with the same filters.

GET /v1/files

Needs an API key: Authorization: Bearer $VIDEXO_API_KEY.

Parameters

Parameters
Name	In	Type	Description
`kind`	query	one of `upload`, `output`	Only uploads or only outputs.
`job`	query	string, up to 64 characters	Only this job's files: its outputs and the uploads it reads that still exist.
`limit`	query	integer, 1 to 100	Files per page, 1 to 100.
`cursor`	query	string, up to 200 characters	The `next_cursor` of the previous page.

Request

bash

curl "$VIDEXO_API_URL/v1/files?kind=upload&limit=20" \
  -H "Authorization: Bearer $VIDEXO_API_KEY"

JavaScript

const response = await fetch(`${process.env.VIDEXO_API_URL}/v1/files?kind=upload&limit=20`, {
  headers: { Authorization: `Bearer ${process.env.VIDEXO_API_KEY}` },
});
const files = await response.json();

Response

200 JSON

{
  "data": [
    {
      "id": "up_0123456789abcdef01234567",
      "kind": "upload",
      "filename": "input.mp4",
      "content_type": "video/mp4",
      "size_bytes": 52428800,
      "sha256": "3b1f5d7a9c2e4f60b8d0a2c4e6f8a0b2c4d6e8f0a1b3c5d7e9f1a3b5c7d9e1f3",
      "state": "complete",
      "job_id": null,
      "alias": null,
      "input_url": "videxo://uploads/up_0123456789abcdef01234567",
      "download_url": null,
      "download_url_expires_at": null,
      "created_at": "2026-11-04T12:00:00.000Z",
      "expires_at": "2026-11-05T12:00:00.000Z"
    }
  ],
  "next_cursor": null
}

Responses

Responses
Status	Body	When
200	FileList	One page of files.
400	Problem	invalid_request
401	Problem	authentication_failed (missing_api_key, invalid_api_key, api_key_revoked, api_key_expired)
403	Problem	permission_denied (token_scope): a client token cannot call this route
404	Problem	not_found (job): `job` names no job of this account
429	Problem	rate_limited