curl --request POST \
  --url https://api.sandbox.trycollate.ai/v1/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fileName": "clinical-note.pdf",
  "contentType": "application/pdf",
  "purpose": "authorization_attachment"
}
'

{
  "file": {
    "id": "file_123",
    "status": "pending_upload",
    "fileName": "clinical-note.pdf",
    "contentType": "application/pdf",
    "sizeBytes": null,
    "purpose": "authorization_attachment",
    "downloadUrl": null,
    "createdAt": "2026-03-13T17:00:00.000Z",
    "completedAt": null
  },
  "upload": {
    "method": "PUT",
    "url": "https://api.example.com/v1/files/file_123/content",
    "headers": {
      "Content-Type": "application/pdf"
    }
  }
}