Skip to main content
POST
Generate file upload URLs for a case
Generate pre-signed upload URLs for adding files to an existing case. This endpoint allows you to upload additional files to cases that have already been created, as long as the case is not locked.
Case Locking: Once you start uploading files to a case, the case becomes locked and you cannot add more files later. Upload all files you need in a single batch.

Permission

Requires organisation_files:write, which every role holds by default. A caller without it receives 403. You can add files to a case you created, or to any case in your organisation if you have organisation_cases:read; otherwise the API returns 404. Shared cases, if enabled for your organisation, also give you reach to every case and file. See Permissions and API Keys.

When to Use This Endpoint

Use Case Creation Upload (POST /cases)

  • When creating a new case with initial files.
  • For the first batch of files in a case.
  • When you know all files upfront.

Use Additional File Upload (POST /cases/{caseId}/files)

  • When adding files to existing unlocked cases.
  • For supplementary documents after initial case creation.
  • When file requirements change during the process.

Authorizations

x-api-key
string
header
required

Path Parameters

caseId
string
required

Case ID

Body

application/json
file_labels
string[]
required
Minimum array length: 1
Required string length: 1 - 255

Response

SAS URLs generated successfully

files
object[]
required