Skip to main content
POST
Confirm an uploaded file

Authorizations

Authorization
string
header
required

Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.

Headers

Sajn-Version
enum<string>

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.

Available options:
2026-09,
2026-10
Sajn-Workspace
string

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.

Idempotency-Key
string

Makes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.

Maximum string length: 255

Path Parameters

id
string
required

The file ID.

Response

File information with access URL

File information with access URL

id
string
required

Unique file identifier

filename
string
required

Original filename

mimeType
string
required

MIME type of the file

size
number
required

File size in bytes

visibility
enum<string>
required

File visibility

Available options:
PRIVATE,
PUBLIC
url
string<uri>
required

URL to access the file (signed URL for private, direct URL for public)

createdAt
string<date-time>
required

Date and time when file was uploaded

updatedAt
string<date-time>
required

Date and time when file was last updated

uploadedBy
object
required

The user who uploaded the file