Sign in
OpenAPI 3.1.02026-08-20360412709.3 KB

0f30448dd2a2

Folders

Move Agent To Folder

Move an agent to a folder or disassociate it from any folder.

  • If folder_id is provided: Associates the agent with that folder
  • If folder_id is null: Disassociates the agent from any folder

Both the agent and folder (if provided) must belong to the user's organization.

put/v1/folders/move-agent

Headers

X-API-Keystring required

API key required to authenticate requests.

Request body

agent_idinteger required

ID of the agent to move

folder_idstring uuid nullable

ID of the target folder (null to disassociate from any folder)

Response

Successful Response

agent_idinteger required

ID of the agent

folder_idstring uuid nullable

ID of the folder (null if disassociated)

statusstring

Status of the operation