Beta

List File Versions

Last updated Nov 19, 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

headerAuthorizationBearer <token>

A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.

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

Successful authorized response.

application/json
  1. response
versions*array<>
request_id*string
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_by": {        "type": "person",        "user_id": "string",        "name": "string",        "via": null      },      "created_at": "2019-08-24T14:15:22Z",      "ready_at": "2019-08-24T14:15:22Z",      "protection": {},      "redacted_from": "string",      "redacted_copy": "string",      "current": true    }  ],  "request_id": "string"}