Skip to main content
PATCH
Reparents a folder. This endpoint only moves folders; it does not rename them.

Path Parameters

string
required
Folder UUID.

Body Parameters

string | null
required
Destination parent folder ID. Send null to move the folder to the root level.

Error Responses

  • 400 invalid_json - malformed JSON body
  • 422 invalid_path - folderId is not a valid UUID
  • 422 invalid_payload - missing or invalid parent_folder_id
  • 404 not_found - folder or parent folder not visible in key scope
  • 409 folder_move_conflict - invalid move (self, descendant, or destination name conflict)
  • 401 - authentication failed (missing/invalid/revoked token)
  • 402 subscription_required - active Creator/Professional/Business plan required
  • 403 tier_not_allowed - Scheduler tier cannot use Partner API
  • 500 folder_update_failed - unexpected failure