Skip to main content
POST
/
v1
/
files
/
{fileId}
/
complete
Complete a file upload
curl --request POST \
  --url https://api.sandbox.trycollate.ai/v1/files/{fileId}/complete \
  --header 'Authorization: Bearer <token>'
{
  "id": "file_123",
  "status": "ready",
  "fileName": "clinical-note.pdf",
  "contentType": "application/pdf",
  "sizeBytes": 48213,
  "purpose": "authorization_attachment",
  "downloadUrl": "https://cdn.example.com/files/authorization_attachment/file_123/clinical-note.pdf",
  "createdAt": "2026-03-13T17:00:00.000Z",
  "completedAt": "2026-03-13T17:11:00.000Z"
}

Authorizations

​
Authorization
string
header
required

Bearer token for WorkOS session JWTs and organization API keys.

Path Parameters

​
fileId
string
required
Example:

"file_123"

Response

File is ready for use.

​
id
string
required
​
status
enum<string>
required
Available options:
pending_upload,
uploaded,
ready,
failed
​
fileName
string
required
​
contentType
string
required
​
sizeBytes
integer | null
required
​
purpose
enum<string>
required
Available options:
authorization_attachment,
sandbox_payer_document,
generated_artifact,
preview_document
​
downloadUrl
string<uri> | null
required
​
createdAt
string<date-time>
required
​
completedAt
string<date-time> | null
required