Skip to content

content_folders_update

Rename, re-parent or reorder a folder.

Tool

content_folders_update

Rename, re-parent or reorder a folder.

Rename, re-parent or reorder a folder. beforeFolderId must be a sibling under the target parent. A move into itself or a descendant is refused as folder_cycle; use content_folders_list to inspect the tree first.

Behavior

HTTP
PATCH /content/folders/:folderId

Arguments

Name
Type
Required
Description
name
string
—
New folder name. Omit to keep it.
folderId
string
•
A folder id from content_folders_list or content_folders_create.
parentId
string
—
New parent folder id, or null to move to the root. Omit to keep the current parent.
beforeFolderId
string
—
Insert before this sibling in the target parent. Omit or set null to put the folder last.

Response

Field
Type
Always
Description
id
string
•
Folder id.
name
string
•
Folder name.
parentId
string
•
Parent folder id, or null at the root.
position
integer
•
Order among siblings with the same parent.
createdAt
string
•
ISO-8601 creation time.
updatedAt
string
•
ISO-8601 time of the last change.

Try it

Rename, re-parent or reorder a folder.

When to use

Rename, re-parent or reorder a folder. beforeFolderId must be a sibling under the target parent. A move into itself or a descendant is refused as folder_cycle; use content_folders_list to inspect the tree first.

Example

Ask your agent something like this:

Rename, re-parent or reorder a folder.

The agent will invoke content_folders_update with these arguments:

{
  "folderId": "<folderId>"
}

Esc

Start typing to search the docs.

↑↓navigate↵select