Skip to Content

Create a file (presigned upload)

You're viewing API version 2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.
POST
/api/v1/files

Create a file record and get a presigned URL to upload the bytes directly to storage.

Flow:

  1. Compute the file's SHA-256 hash and base64-encode it.
  2. Call this endpoint with the filename, MIME type, size, and checksum. You receive a fileId and a presigned uploadUrl.
  3. PUT the raw bytes to uploadUrl with headers Content-Type: <mimeType> and x-amz-checksum-sha256: <checksum>. S3 verifies the checksum on write.
  4. (Recommended) Call POST /api/v1/files/:id/confirm to verify the upload and flip the record to CONFIRMED immediately. Otherwise it is confirmed automatically the first time it is fetched via GET /api/v1/files/:id.

Why: the bytes go straight to storage, so there is no API-server size limit.

Authorization

headerAuthorizationBearer <token>

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

Header Parameters

authorization*string

Bearer token for API authentication

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.

Lengthlength <= 255

Request Body

Body

application/json
  1. body

Request a presigned upload URL and create a pending file record

fileName*string

Original filename including its extension

Length1 <= length <= 255
mimeType*string

MIME type of the file

Value in"application/pdf""application/msword""application/vnd.openxmlformats-officedocument.wordprocessingml.document""application/vnd.ms-excel""application/vnd.openxmlformats-officedocument.spreadsheetml.sheet""application/vnd.ms-powerpoint""application/vnd.openxmlformats-officedocument.presentationml.presentation""video/mp4""video/quicktime""video/x-msvideo""video/webm""image/jpeg""image/png""image/gif""image/webp""image/svg+xml"
size*integer

File size in bytes (max 25 MB)

Range0 < value <= 26214400
checksum*string

Base64-encoded SHA-256 checksum of the file. S3 enforces it on upload, so a mismatch rejects the bytes.

Length1 <= length
visibility*string

File visibility (default PRIVATE)

Default"PRIVATE"
Value in"PRIVATE""PUBLIC"

Response Body

Presigned upload details

application/json
  1. response

Presigned upload details

fileId*string

The created file record id. Status is PENDING until the upload is confirmed on first access.

key*string

The S3 object key the file will be stored under

uploadUrl*string

Presigned PUT URL (valid 1 hour). Upload the bytes here with headers Content-Type: and x-amz-checksum-sha256: .

Formaturi
Example Request
curl -X POST 'https://app.sajn.se/api/v1/files' \  -H 'authorization: string' \  -H 'Content-Type: application/json' \  -d '{  "fileName": "string",  "mimeType": "application/pdf",  "size": 1,  "checksum": "string",  "visibility": "PRIVATE"}'
Example Response
{  "fileId": "string",  "key": "string",  "uploadUrl": "http://example.com"}

Was this page helpful?