Create a folder

POST 
/api/v2/folders

Creates the folder with any missing parents (mkdir -p). An existing folder or file of that path returns 409 file_exists; /data/shared returns 403.

Request

Responses

201

The new folder

400

Malformed request

Response Headers

X-Contract-Version

Version of the gaius-api-contracts release the backend runs (legalgpt-contracts), sent on every response. Clients compare it with the @legalgpt/contracts version they were built with; both packages share one version per contract.

Cache-Control

Prevents storage of sensitive authenticated chat data.

Content-Language

Language selected for outgoing generic tool-status labels and known HTTP/timeline error text. HTTP reason-phrase titles remain language-neutral.

401

Missing or invalid API key

Response Headers

X-Contract-Version

Version of the gaius-api-contracts release the backend runs (legalgpt-contracts), sent on every response. Clients compare it with the @legalgpt/contracts version they were built with; both packages share one version per contract.

Cache-Control

Prevents storage of sensitive authenticated chat data.

Content-Language

Language selected for outgoing generic tool-status labels and known HTTP/timeline error text. HTTP reason-phrase titles remain language-neutral.

403

Authenticated, but the API key's account has no access to this resource

Response Headers

X-Contract-Version

Version of the gaius-api-contracts release the backend runs (legalgpt-contracts), sent on every response. Clients compare it with the @legalgpt/contracts version they were built with; both packages share one version per contract.

Cache-Control

Prevents storage of sensitive authenticated chat data.

Content-Language

Language selected for outgoing generic tool-status labels and known HTTP/timeline error text. HTTP reason-phrase titles remain language-neutral.

409

file_exists: the target name is taken. folder_busy: an upload is still being processed into the folder. vault_locked: the encrypted storage is locked.