Skip to navigation

Upload a supporting document in one step

View as Markdown

Stores a supporting document against the application in a single call: send the file as a multipart/form-data part named file and the bytes go through this API to storage. The document is listed by GET …/documents immediately, with no confirmation step.

Limited to 10MB. For anything larger, use POST …/documents, which returns a presigned URL and sends the bytes straight to storage without passing through this API.

The filename and content type are taken from the multipart part. 404 if the application is unknown.

Authentication

AuthorizationBearer

Paste a Keycloak access token (no "Bearer " prefix)

Path parameters

idstringRequiredformat: "uuid"

Request

This endpoint expects a multipart form containing an optional file.
filefileOptional

Response

The document was stored.
idstringOptionalformat: "uuid"
filenamestringOptional
The file's original name.
contentTypestringOptional
sizeByteslongOptional

Size in bytes. Null while the document is still PENDING.

statusenumOptional

UPLOADED when the file bytes are stored and can be downloaded. PENDING when the entry was created but the bytes never arrived — ask for a fresh upload URL and retry, or delete the entry.

Allowed values:
uploadedBystringOptional
The principal that uploaded it.
uploadedAtdatetimeOptional

When the entry was created, which for a PENDING document is not when anything was uploaded.

Errors

413
Content Too Large Error