Folders | Tarkle Docs

Method and path	Scope	What it does
`POST /folders`	`files:write`	Create a folder

curl -X POST -H "Authorization: Bearer $TARKLE_TOKEN" -H "X-Workspace-Key: $KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Invoices", "parent_id": null}' \
  https://tarkle.com/api/v1/folders

name is required. parent_id is a folder id, or omitted for the root. The answer is 201 with the new folder.

A file and a folder share one namespace, compared ignoring case, so a taken name in that folder is 409 name_taken. Names cannot be empty, . or .., contain / or control characters, or be longer than 255 bytes (400 invalid_name, 400 name_too_long).

To list, rename, move or delete a folder use Files. Deleting a folder moves it and everything in it to the bin.