Rename or move a file

PATCH 
/api/v2/files/:file_id

Renames the file, moves it to another existing folder of the account's drive, or both. The file keeps its id. A taken target name returns 409 file_exists; /data/shared returns 403.

Request

Responses

200

The file under its new path

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.

404

Resource does not exist or is not visible to the caller

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.