Rename or move a folder

posthttps://api.expiryedge.com/v1/updateFolder

editor or admin60/minAny method

Request

curl -X POST 'https://api.expiryedge.com/v1/updateFolder?id=fld_8Tz4' \
  -H "Authorization: Bearer $EXPIRYEDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "State Dental Board",
  "parent_folder_id": "fld_2Kp9"
}'

Response

{
  "success": true,
  "message": "Folder updated successfully",
  "folder": {
    "id": "fld_8Tz4",
    "name": "State Dental Board",
    "parent_folder_id": "fld_2Kp9",
    "folder_path": "/Licenses/State Dental Board",
    "user_id": "u_71bXq",
    "organization_id": "org_northwind",
    "is_deleted": false,
    "created_at": "2026-09-27T14:06:00.000Z",
    "updated_at": "2026-09-28T09:12:00.000Z"
  }
}

Id from the id query parameter (or body id). Send name to rename and/or parent_folder_id to move (null = root). Moves that would create a cycle return 400; descendants' folder_path is recomputed.

Query parameters

idstring
Folder id (alternative to body id).

Body parameters

application/json

idstring
Folder id (used when id is not in the query).
namestring
max length: 255
parent_folder_idstring | null

Returns

200

Folder updated. folder is the stored folder merged with the changes (no children or expiry_count).

successbooleanrequired
messagestringrequired
folderobjectrequired
A folder for organizing expiries. Folders nest via parent_folder_id.

Errors

`400`	The request is missing required fields or contains invalid values.
`401`	Missing, expired or invalid bearer token.
`403`	Authenticated, but your role or organization does not allow this action.
`404`	The record does not exist or is not in your organization.
`409`	A folder with this name already exists in this location.
`429`	Too many requests for this endpoint from your IP. Wait `Retry-After` seconds.
`500`	Unexpected server error. Retry later; quote `requestId` to support.