Sign in
Files

Get file metadata

Retrieves metadata for a single file owned by the requesting workspace.

get/files/{file_id}

Path parameters

file_idstring required
Example:file_011CNha8iCJcU1wXNR6q4V8w

Query parameters

workspace_idstring uuid

Workspace to scope the request to. Defaults to the caller’s default workspace.

Example:a103d8b6-42f0-4e50-9a3c-bf41e2c3c1a7

Workspace to scope the request to. Defaults to the caller’s default workspace.

Response

The file metadata.

created_atstring required
downloadableboolean required
filenamestring required
idstring required
mime_typestring required
size_bytesinteger required
type'file' required

Example response

{
  "created_at": "2025-01-01T00:00:00Z",
  "downloadable": false,
  "filename": "document.pdf",
  "id": "file_011CNha8iCJcU1wXNR6q4V8w",
  "mime_type": "application/pdf",
  "size_bytes": 1024000,
  "type": "file"
}

Changes