Create file
Uploads a PDF and returns its file_ ID. Send it as multipart/form-data in a field named
file, with an optional purpose field. Only PDFs are accepted; the content is checked, not
the file name or declared type.
The purpose says what may attach the file, and decides the permission it needs:
| purpose | Attached by | Requires | Size limit |
|---|---|---|---|
tax_document (default) | Create income upload, Create franchise upload | Taxes: Manage | None beyond the network path’s request limits |
bank_statement | Reconcile reconciliation (statement_file_id) | Reconciliation: Manage | 10 MB, as on the Reconciliation page |
A file belongs to the company of the key that uploaded it, attaches once, only to what its
purpose names, and is deleted if nothing attaches it within 24 hours (expires_at).
To upload without multipart (an AI agent connected through the MCP, for example), use Create file upload.
Authorizations
Body
What may attach the file. tax_document is a filed tax return or Delaware franchise tax report, for Create income upload or Create franchise upload; it needs Taxes: Manage. bank_statement is a bank or card statement, for Reconcile reconciliation; it needs Reconciliation: Manage and can be at most 10 MB.
tax_document, bank_statement Response
The file was stored and can be attached until expires_at.
What may attach the file. tax_document is a filed tax return or Delaware franchise tax report, for Create income upload or Create franchise upload; it needs Taxes: Manage. bank_statement is a bank or card statement, for Reconcile reconciliation; it needs Reconciliation: Manage and can be at most 10 MB.
tax_document, bank_statement