Skip to main content
PUT
Move an agent to a folder
Requires Editor, Admin, or Owner. Send the destination numeric folder_id, or null to remove the folder assignment. The destination folder and agent must belong to the requested workspace; otherwise the operation returns 404. The response is an agent summary. Moving an agent changes its organization within the workspace; it does not move the agent to another workspace or publish its draft.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Path Parameters

workflow_id
integer
required

Body

application/json
folder_id
integer | null

Response

Successful Response

created_at
string<date-time>
required
id
integer
required

Numeric workspace agent ID used by management endpoints.

name
string
required
status
string
required
total_runs
integer
required

Number of runs recorded for this agent.

assistant_mode
string | null
created_by
string | null
folder_id
integer | null

Workspace folder ID, or null for Uncategorized.

workflow_uuid
string | null

Stable agent UUID used by the call-by-agent endpoint.