Storage File

Get a single storage file

Info

Required scope: storage.read

Warning

This method requires authentication

Retrieve details of a specific file in the user's video storage. See Storage Files for the list of possible status values.

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

Path Parameters:

ParameterTypeDescription
fileIdstringThe ID of the storage file (required)

Response

Success
Error (Invalid Token)
Error (Not Found)
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "title": "My stream recording.mp4",
  "sizeBytes": 104857600,
  "durationSeconds": 3600,
  "status": "Ready",
  "createdAt": "2026-02-26T22:01:19.000Z"
}