GetbeelDocs

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.

POST
/drive/files

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.

Autorizzazione

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Idempotency-Key?string

Recommended. 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.

Lengthlength <= 255
Getbeel-Company?string

Act 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.

Formatuuid
application/json
  1. body
folder*string

Where it goes: a month (2026-10), documents, or a custom folder path from GET /drive (writable true)

Match^(\d{4}-(0[1-9]|1[0-2])|(\d{4}-(0[1-9]|1[0-2])\/)?[a-z0-9]+(-[a-z0-9]+)*)$
Lengthlength <= 100
file_url?string

Public https URL of the file (no redirects)

Formaturi
Lengthlength <= 2048
file_base64?string

The file, base64-encoded

Lengthlength <= 34952538
file_name?string

File name, e.g. contratto-affitto.pdf (required with file_base64)

Length1 <= length <= 255

Corpo della risposta

OK

application/json
  1. response
object*string
id*string
name*string
kind*string

invoice: a received invoice’s file; reconciliation: an uploaded bank statement; document: an uploaded document

Value in"invoice""reconciliation""document"
folder*string

The path of its folder

mime_type*string|null
size*|null
created_at*string|null
document_date*|

Invoice date for invoice files, else the upload date

month*string|null
vendor_name*string|null
Esempio di richiesta
curl -X POST 'https://www.getbeel.com/api/v1/drive/files' \  -H 'Content-Type: application/json' \  -d '{  "folder": "2026-10"}'
Esempio di risposta
{  "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"}