KintsugiKintsugi
API reference / Replace one file under a many-file compliance document type

Replace one file under a many-file compliance document type

PUT/compliance-documents/files/{document_id}

Replace the bytes of one stored file under a many-file catalog type, as multipart/form-data with the file in the file part. Returns 400 when the file belongs to a one-file catalog type. The file must be a PDF, JPG, or PNG of at most 10 MB. Requires an Owner user credential.

Authorization

AuthorizationstringRequired

A signed-in user's session token, sent as Authorization: Bearer <token>. It authorizes the organizations that user can reach. Operations that manage people accept only this credential; operations on data also accept an API key.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Path parameters

document_idstringRequired

The unique identifier of the stored file.

Response

idstringRequired

Kintsugi's unique identifier for the stored file.

fileNamestringRequired

Name the file was uploaded under.

contentTypestringRequired

Media type of the file.

sizeintegerRequired

Size of the file in bytes.

createdAtstringRequired

When the file was first stored, as an RFC-3339 UTC timestamp.

updatedAtstringRequired

When this stored row was last written, as an RFC-3339 UTC timestamp. Set when the file is created (same moment as createdAt) and again when PUT /compliance-documents/files/{id} overwrites that id. A one-file PUT on the catalog type mints a new id, so both timestamps are the time of that new row.

200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

409

The request conflicts with existing state.

413

The request body is larger than this endpoint accepts.

422

The request failed validation.

500

An unexpected error prevented the request from completing.

503

A service this request depends on was unavailable. Retry the request.

cURL
PUT /compliance-documents/files/{document_id}
-H "Authorization: Bearer ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/compliance-documents/files/{document_id}
Response
{
"id": "cdoc_2mNpQr7Ls8f3k",
"fileName": "ein-confirmation.pdf",
"contentType": "application/pdf",
"size": 20481,
"createdAt": "2026-09-18T12:00:00Z",
"updatedAt": "2026-09-18T15:00:00Z"
}
Replace one file under a many-file compliance document type (2026-07-21) | Kintsugi API Reference