Create a Drive folder
A new uploads folder at the root or inside a month (that month’s folder is created if missing). Its path comes from the name; a name shaped like a month is refused. 409 folder_exists when one with that name is already there. Live keys only.
A new uploads folder at the root or inside a month (that month’s folder is created if missing). Its path comes from the name; a name shaped like a month is refused. 409 folder_exists when one with that name is already there. 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
name*stringFolder name; its path comes from it (letters, digits and dashes)
1 <= length <= 80month?stringCreate it inside this month’s folder instead of the root
^\d{4}-(0[1-9]|1[0-2])$OK
application/json- response
object*stringpath*stringinvoices and reconciliation (system folders), a month (2026-10), or an uploads folder (documents, contratti, 2026-10/contratti)
name*stringkind*string"system""month""custom"month*string|nullfile_count*integer-9007199254740991 <= value <= 9007199254740991total_size*integerBytes
-9007199254740991 <= value <= 9007199254740991updated_at*string|nullwritable*booleanUploads can go here (not the system folders)
curl -X POST 'https://www.getbeel.com/api/v1/drive/folders' \ -H 'Content-Type: application/json' \ -d '{ "name": "Contratti"}'{ "object": "drive_folder", "path": "string", "name": "string", "kind": "system", "month": "string", "file_count": -9007199254740991, "total_size": -9007199254740991, "updated_at": "string", "writable": true}Delete a Drive file DELETE
Deletes the file (id from GET /drive) for good, as Delete in the Drive page: a received invoice’s file (the invoice stays, without its file; also needs received_invoices:write), an uploaded bank statement (also needs bank:write) or an uploaded document. A statement holding autofatture that are or may be at SDI cannot be deleted (409 statement_has_sent_autofatture). Live keys only.
Delete a Drive folder DELETE
Deletes a custom folder (path from GET /drive, kind custom) and every file in it, for good. Month and system folders cannot be deleted. Live keys only.