API version

API reference / Add a file to a many-file compliance document type

Add a file to a many-file compliance document type

POST/compliance-documents/{catalog_type}

Add a file under a many-file catalog type, as multipart/form-data with the file in the file part. Returns 400 when the catalog type holds only one file. 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.

201

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

POST /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"

}