Upload a support document for a pre-appointment

POST 
/v1/checkin/appointments/:id/documents

Uploads a support document as multipart/form-data with two parts: a binary file part and a request_data part (Content-Type application/json) carrying the metadata. provider_product_codes selects the target charges: empty/absent completes the PENDING placeholders of all charges of the pre-appointment for the given support_file_code (case-insensitive); a non-empty list restricts completion to the matching charges (codes without a corresponding charge are silently ignored). The file is uploaded to storage only once and shared across every completed placeholder. Returns 201 with one array element per completed document. Supported file types: PDF, JPEG, and PNG. Maximum file size: 25MB.

Request

Responses

201

Document(s) uploaded successfully: one array element per completed placeholder

401

Unauthorized: missing or invalid Bearer token

403

Forbidden - your credentials are not authorised for this operation

404

Pre-appointment not found or does not belong to the authenticated provider

413

Uploaded file exceeds the maximum allowed size (25MB)

422

Request validation failed, unsupported file type (MIME type not in whitelist, missing support_file_code, invalid pattern, or missing file), or no PENDING placeholder matches the given support_file_code and provider_product_codes

502

Bad Gateway: document storage service is unavailable