Assistant API

Helpers for the platform assistant, such as attachment validation.

📄️Stage large chat attachment and get adoption ticket

Uploads a chat attachment that is too large for an inline data URL through the resumable chunked protocol (the same one the collection upload endpoint speaks). The assembled bytes land at their checksum-addressed location in the files bucket; the final response carries a one-shot ticket URL (`docana-attachment:<id>`) to put on the message in place of the data URL. No Document is created until the message that carries the ticket is processed.

📄️Validate file attachments

Checks each file’s MIME type and size before the client uploads it to an assistant chat. The accepted set is broader than the model’s native attachments: convertible and Docana-only types pass with their own size limits, and when code execution is enabled for the application any type is accepted. Validation never stores the files.