Upload a document to the Drive
Uploads a document into a folder that takes uploads (writable true in GET /drive: a month, documents or a custom folder; a month folder is created if missing), by public https file_url or file_base64. PDF, PNG, JPEG, DOC or DOCX, up to 25 MB, the type read from the content (413 payload_too_large, 415 unsupported_file_type). It is only stored: to have the AI read a supplier invoice, use POST /received-invoices/uploads. Live keys only.
Uploads a document into a folder that takes uploads (writable true in GET /drive: a month, documents or a custom folder; a month folder is created if missing), by public https file_url or file_base64. PDF, PNG, JPEG, DOC or DOCX, up to 25 MB, the type read from the content (413 payload_too_large, 415 unsupported_file_type). It is only stored: to have the AI read a supplier invoice, use POST /received-invoices/uploads. Live keys only.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
Idempotency-Key?stringRecommended. Retrying with the same key and body within 24 hours replays the first response (header Idempotent-Replayed: true) instead of acting twice. The same key with a different body returns 422 idempotency_key_reused.
length <= 255Getbeel-Company?stringAct on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.
uuidapplication/json- body
folder*stringWhere it goes: a month (2026-10), documents, or a custom folder path from GET /drive (writable true)
^(\d{4}-(0[1-9]|1[0-2])|(\d{4}-(0[1-9]|1[0-2])\/)?[a-z0-9]+(-[a-z0-9]+)*)$length <= 100file_url?stringPublic https URL of the file (no redirects)
urilength <= 2048file_base64?stringThe file, base64-encoded
length <= 34952538file_name?stringFile name, e.g. contratto-affitto.pdf (required with file_base64)
1 <= length <= 255OK
application/json- response
object*stringid*stringname*stringkind*stringinvoice: a received invoice’s file; reconciliation: an uploaded bank statement; document: an uploaded document
"invoice""reconciliation""document"folder*stringThe path of its folder
mime_type*string|nullsize*|nullcreated_at*string|nulldocument_date*|Invoice date for invoice files, else the upload date
month*string|nullvendor_name*string|nullcurl -X POST 'https://www.getbeel.com/api/v1/drive/files' \ -H 'Content-Type: application/json' \ -d '{ "folder": "2026-10"}'{ "object": "drive_file", "id": "string", "name": "string", "kind": "invoice", "folder": "string", "mime_type": "string", "size": -9007199254740991, "created_at": "string", "document_date": "string", "month": "string", "vendor_name": "string"}List a month or folder of the Drive GET
The folders and files of one month (month=2026-10: invoice files by invoice date, statements and uploads by upload date) or of one uploads folder (folder=contratti or 2026-10/contratti), newest first. Invoice files also need received_invoices:read and bank statements bank:read; without them they are left out. Both key modes.
Download a Drive file GET
A private link to the file (id from GET /drive), valid 15 minutes. Invoice files also need received_invoices:read and bank statements bank:read; without them they are left out.