# Add or replace a one-file compliance document

> PUT /compliance-documents/{catalog_type}

Source: https://docs.trykintsugi.com/reference/2026-07-21/add-or-replace-a-one-file-compliance-document

PUT /compliance-documents/{catalog_type}

Add or replace a one-file compliance document

Put the single file for a one-file catalog type, as `multipart/form-data` with the file in the `file` part. Creates the slot on first upload and replaces the stored file after that. A replace deletes the previous file and returns a new `id`; do not reuse the old id for preview. Returns 400 when the catalog type holds many files. The file must be a PDF, JPG, or PNG of at most 10 MB. Requires an Owner user credential.

Category: Compliance Documents

Path parameters:
catalog_type (string, required) - Catalog type id.
  allowed values: acquisition_documentation, articles_of_incorporation, bank_account_certificate, bank_statement, business_license, business_registration_certificate, certificate_of_authority, certificate_of_formation, certificate_of_incorporation, customs_documents, dba_registration_document, drivers_license (and 18 more, see the reference page)

Response fields:
id (string, required) - Kintsugi's unique identifier for the stored file.
fileName (string, required) - Name the file was uploaded under.
contentType (string, required) - Media type of the file.
size (integer, required) - Size of the file in bytes.
createdAt (string, required) - When the file was first stored, as an RFC-3339 UTC timestamp.
updatedAt (string, required) - 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.

Response statuses: 200, 400, 401, 403, 404, 409, 413, 422, 500, 503

---

Index of every page: https://docs.trykintsugi.com/llms.txt
