Rename or move a folder

Renames a folder, or moves it under a different parent.

Rename wins over move. The two operations are mutually exclusive in one call: if name is present the folder is renamed and parentUploadFolderId is ignored entirely. Send two requests to do both.

To move a folder to the top level, send parentUploadFolderId as null or false. Names must stay unique within the destination.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
curl -X PATCH 'https://apis.elai.io/api/v1/uploads/folders/66a1f0c2b7cd13032a9c6500' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Renamed folder"
}'
Path Params
string
required
Body Params
string

New name. Takes precedence over parentUploadFolderId.

New parent, or null/false for the top level. Only honoured when name is absent.

Responses

name present but empty, duplicate name in the destination, folder not found, or the destination parent belongs to another workspace.

locked and the increaseUserLockedRolePrivileges feature flag is off.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json