Patch Folder
Folders
Update a Folder
Rename and/or move a folder. Rejects cycles.
PATCH
Patch Folder
Renames and/or moves a folder. Only the fields you send are changed (Pydantic
exclude_unset), and parent_id is treated specially: to move a folder back to root, send "parent_id": null explicitly — the endpoint distinguishes that from omitting the field entirely.
Moving a folder rejects cycles: the endpoint fetches every folder in the org and walks the in-memory tree to find every descendant of the folder being moved (org folder counts are assumed small), then rejects the move with 400 if the proposed new parent is one of those descendants or is the folder itself — rather than corrupting the tree.
Folder names are unique per parent, case-insensitively — the same (org_id, parent_id, lower(name)) constraint as Create a Folder — so renaming into a collision returns 409.
Auth
Requires a CRM manage scope and an active organization on the token. Any*:manage scope qualifies — in practice contacts:manage, deals:manage, companies:manage, or activities:manage.
Response
Returns the updated folder row (same shape as List Folders’sfolders[]).
Errors
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
UUID of the folder to rename and/or move.
Body
application/json
Response
Successful Response
The response is of type Response Patch Folder Folders Folder Id Patch · object.