SMBBETA

List File Versions

Last updated Oct 10, 2026View as MarkdownAgent setup / MCP
GET
/v1/files/{file_id}/versions

Lists the 100 most recent versions of an accessible File, newest first, and marks the one in use. Versions still uploading or blocked by scanning are listed with their processing status. People who can only view the File see just the version in use.

Authorization

AuthorizationBearer <token>

Signed-in user's Supabase access token. Workspace-scoped operations also require SMB-Workspace-Id.

In: header

Path Parameters

file_id*string

Stable File ID.

Match^fil_[0-7][0-9A-HJKMNP-TV-Z]{25}$

Header Parameters

SMB-Workspace-Id*string

Workspace where this operation runs. Required for user tokens and Workspace API keys.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/files/string/versions" \  -H "SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "versions": [    {      "file_version_id": "string",      "version_number": 1,      "content_type": "string",      "size_bytes": 1,      "sha256": "string",      "processing_status": "pending_upload",      "processing_error": "string",      "summary": "string",      "created_at": "2019-08-24T14:15:22Z",      "ready_at": "2019-08-24T14:15:22Z",      "current": true    }  ],  "request_id": "string"}