API version

API reference / Add or replace a one-file compliance document

Add or replace a one-file compliance document

PUT/compliance-documents/{catalog_type}

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.

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

catalog_typestringRequired

Catalog type id.

Available options:acquisition_documentationarticles_of_incorporationbank_account_certificatebank_statementbusiness_licensebusiness_registration_certificatecertificate_of_authoritycertificate_of_formationcertificate_of_incorporationcustoms_documentsdba_registration_documentdrivers_licensefictitious_business_name_certificateforeign_qualification_documentforeign_tax_idfulfillment_agreementgovernment_letterirs_501c3_determination_letterirs_ein_confirmation_letterlocal_tax_numbermarketplace_seller_screenshotsname_change_documentationnational_idpassportpower_of_attorneysales_reportsshipping_invoicesutility_billvoid_checkwarehouse_agreement

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/acquisition_documentation

-H "Authorization: Bearer ***"

-H "Api-Version: 2026-07-21"

Example request

https://api.trykintsugi.com/compliance-documents/acquisition_documentation

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"

}