Attach Files to Submission

Attaches one or more files to an existing submission. The files appear in the submission’s Files tab and are downloadable from there.

The request body must be multipart/form-data with each file in a part named file. Repeat the same field name for multiple files.

Constraints:

• At least one file is required.
• All files must be submitted in a single request. Files are not partially attached on validation failure — either every file lands or none do.

Required permission: submission.file:create

POST /api/external/companies/{companyId}/submissions/{submissionId}/files

Attach Files to Submission

cURL

curl --request POST \
  --url https://app.aiinsurance.io/api/external/companies/{companyId}/submissions/{submissionId}/files \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'

201

success

{
  "fileIds": [
    "550e8400-e29b-41d4-a716-446655440010",
    "550e8400-e29b-41d4-a716-446655440011"
  ]
}

Authorizations

Authorization · string · header · required

API key authentication. Include your API key in the Authorization header.

Path Parameters

companyId · string<uuid> · required

Company identifier

submissionId · string<uuid> · required

Submission identifier

Body

multipart/form-data

file · file · required

A file to attach. Repeat this field for multiple files.

Response

201

application/json

Files attached successfully. Returns the IDs of the created files in upload order.

fileIds · string<uuid>[] · required

IDs of the newly created files, in the order received in the request.