Create a new document collection

post

https://prod.truv.com/v1/documents/collections/

The endpoint creates a new document collection and uploads documents in a single request. Documents are provided as base64-encoded content in JSON format. The uploaded files are automatically validated and queued for AI-powered categorization.

Body Params

documents

array of objects

required

length between 1 and 10

Array of documents to upload (maximum 10 files per request)

Documents*

filename

string

required

length ≤ 255

mime_type

string

enum

required

content

string

required

length between 1336 and 13333336

Base64-encoded file content. Maximum file size: 10 MB (10,000,000 bytes). Minimum file size: 1 KB (1,000 bytes). Note: maxLength accounts for base64 encoding overhead (4/3 ratio).

user_id

string | null

Truv user ID to assign this document to (optional, mutually exclusive with external_user_id)

external_user_id

string | null

External system user ID to assign this document to (optional, mutually exclusive with user_id)

users

array of objects

Array of users to create/update in this collection (optional). Documents can be automatically matched to users by name, or explicitly assigned via user_id/external_user_id in the documents array.

Users

Responses

Language

Credentials

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201

400HTTP 400 Bad Request

401HTTP 401 Unauthorized

403HTTP 403 Forbidden