GetbeelDocs

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.

POST
/drive/folders

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.

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
name*string

Folder name; its path comes from it (letters, digits and dashes)

Length1 <= length <= 80
month?string

Create it inside this month’s folder instead of the root

Match^\d{4}-(0[1-9]|1[0-2])$

Corpo della risposta

OK

application/json
  1. response
object*string
path*string

invoices and reconciliation (system folders), a month (2026-10), or an uploads folder (documents, contratti, 2026-10/contratti)

name*string
kind*string
Value in"system""month""custom"
month*string|null
file_count*integer
Range-9007199254740991 <= value <= 9007199254740991
total_size*integer

Bytes

Range-9007199254740991 <= value <= 9007199254740991
updated_at*string|null
writable*boolean

Uploads can go here (not the system folders)

Esempio di richiesta
curl -X POST 'https://www.getbeel.com/api/v1/drive/folders' \  -H 'Content-Type: application/json' \  -d '{  "name": "Contratti"}'
Esempio di risposta
{  "object": "drive_folder",  "path": "string",  "name": "string",  "kind": "system",  "month": "string",  "file_count": -9007199254740991,  "total_size": -9007199254740991,  "updated_at": "string",  "writable": true}