Storage Files

List user's storage files

Info

Required scope: storage.read

Warning

This method requires authentication

Retrieve a list of all files in the user's video storage.

The status field indicates the current processing state of the file:

Processing — file is being uploaded, analyzed, transcoded, or imported
Ready — file is ready for use
Failed — file processing failed

sizeBytes and durationSeconds may be null while the file is still being processed.

curl -H "Authorization: Bearer [access token]" \
     https://api.restream.io/v2/user/storage/files

Response

Success

Error

{
  "files": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "My stream recording.mp4",
      "sizeBytes": 104857600,
      "durationSeconds": 3600,
      "status": "Ready",
      "createdAt": "2026-02-26T22:01:19.000Z"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "title": "Intro video.mp4",
      "sizeBytes": null,
      "durationSeconds": null,
      "status": "Processing",
      "createdAt": "2026-02-20T10:30:00.000Z"
    }
  ]
}