Skip to main content
POST
Presign a company-document upload
Step 1 of the assisted-lane company-document upload. Returns a short-lived presigned S3 URL to PUT the entity’s document to directly from the browser — the file bytes never transit our server (max 20 MB). Then confirm the upload with Attach a company document, passing the returned s3_key. Requires the documents:write scope.

Authorizations

Authorization
string
header
required

Bearer API key issued from Settings → Developers in your Instant Compliance organisation. Format: ic_live_….

Path Parameters

id
string
required

Entity identifier (UUID or your external_id).

Body

application/json
fileName
string
required
Required string length: 1 - 512
contentType
string
Required string length: 1 - 255
fileSize
integer

Best-effort hint; the true size is re-checked from S3 on confirm.

Response

A presigned PUT URL and the key to confirm with.

upload_url
string<uri>

Presigned S3 URL to PUT the file to (expires in 10 minutes).

s3_key
string

Pass this back to POST /entities/{id}/documents to confirm.