Upload a supporting document

PUT

https://api.crisscross.money/v1/toc/orders/:orderId/document-requirements/:docId

Uploads or replaces a supporting document for a specific BOP requirement slot on an order. Idempotent — re-uploading replaces the previous file and resets the document status to uploaded. Max file size: 50 MB. Allowed MIME types: image/png, image/jpeg, application/pdf.

Authentication

AuthorizationBearer

Token obtained via the login flow.

Path parameters

orderIdstringRequired

docIdstringRequired

Request

This endpoint expects a multipart form containing a file.

filefileRequired

The file to upload (PNG, JPEG, or PDF; max 50 MB).

Response

Document uploaded successfully.

idstring

orderIdstring

labelstring

Human-readable document label from the BOP document requirement.

requiredboolean

Whether this document is mandatory for this BOP category.

statusenum

Current upload and review status of this document slot.

originalFilenamestring or null

contentTypestring or null

fileSizeByteslong or null

uploadedAtdatetime or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

$	curl -X PUT https://api.crisscross.money/v1/toc/orders/ord_550e8400-e29b-41d4-a716-446655440000/document-requirements/doc_550e8400-e29b-41d4-a716-446655440000 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: multipart/form-data" \
>	-F file=@string

1	{
2	"id": "doc_c1d2e3f4-e5f6-7890-abcd-ef1234567890",
3	"orderId": "ord_550e8400-e29b-41d4-a716-446655440000",
4	"label": "Pro Forma Invoice",
5	"required": true,
6	"status": "uploaded",
7	"originalFilename": "invoice-2026-001.pdf",
8	"contentType": "application/pdf",
9	"fileSizeBytes": 245780,
10	"uploadedAt": "2026-05-22T09:00:00Z"
11	}