Get file by ID
Retrieve file information and access URL.
URL Generation:
- For
PRIVATEfiles: Returns a fresh signed URL (valid for 15 minutes) - For
PUBLICfiles: Returns the permanent CloudFront URL
Response includes:
- File metadata (filename, size, MIME type)
- Visibility setting
- Access URL
- Upload information
Authorizations
Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
Headers
API version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.
2026-09, 2026-10 ID of the workspace this request acts in, from GET /api/v1/workspaces. Without it, an API key acts in its default workspace. The token's user must be a member of the workspace; an OAuth token only accepts the workspace it was granted for. A workspace that doesn't exist or can't be reached returns 403 WORKSPACE_ACCESS_DENIED.
Path Parameters
The file ID.
Response
File information with access URL
File information with access URL
Unique file identifier
Original filename
MIME type of the file
File size in bytes
File visibility
PRIVATE, PUBLIC URL to access the file (signed URL for private, direct URL for public)
Date and time when file was uploaded
Date and time when file was last updated
The user who uploaded the file

