Agent Folders

Organize agents (Assignments in the Duvo UI) into folders

get

List all agent folders for the authenticated team.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Responses

200

Default Response

application/json

401

Default Response

application/json

500

Default Response

application/json

get

/v1/agent-folders

HTTPcURLJavaScriptPython

GET /v1/agent-folders HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "folders": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "team_id": "123e4567-e89b-12d3-a456-426614174000",
      "parent_folder_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "text",
      "updated_at": "text",
      "agent_count": 1,
      "subfolder_count": 1
    }
  ]
}

post

Create a new agent folder.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Body

application/json

namestring · min: 1 · max: 100Required

Human-readable folder name

parent_folder_idstring · uuid · nullableOptional

Parent folder ID for nested folders. Omit or null to create at the root level.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Responses

201

Default Response

application/json

400

Default Response

application/json

401

Default Response

application/json

500

Default Response

application/json

post

/v1/agent-folders

HTTPcURLJavaScriptPython

POST /v1/agent-folders HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "name": "text",
  "parent_folder_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "folder": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "team_id": "123e4567-e89b-12d3-a456-426614174000",
    "parent_folder_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "text",
    "updated_at": "text"
  }
}

delete

Delete an agent folder. If the folder contains assignments or subfolders, pass force=true to delete it and move the contained assignments to the root level.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Path parameters

folder_idstring · uuidRequired

The folder's unique identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Query parameters

forcestringOptional

Pass 'true' to delete a folder that still contains assignments or subfolders. Any contained assignments will be moved to the root level.

Responses

200

Default Response

application/json

successbooleanRequired

Always true on success

400

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

delete

/v1/agent-folders/{folder_id}

HTTPcURLJavaScriptPython

DELETE /v1/agent-folders/{folder_id} HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true
}

patch

Rename an agent folder or move it to a new parent.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Path parameters

folder_idstring · uuidRequired

The folder's unique identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Body

application/json

namestring · min: 1 · max: 100Optional

New folder name

parent_folder_idstring · uuid · nullableOptional

New parent folder ID. Pass null to move the folder to the root level.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Responses

200

Default Response

application/json

400

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

patch

/v1/agent-folders/{folder_id}

HTTPcURLJavaScriptPython

PATCH /v1/agent-folders/{folder_id} HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "name": "text",
  "parent_folder_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "folder": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "team_id": "123e4567-e89b-12d3-a456-426614174000",
    "parent_folder_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "text",
    "updated_at": "text"
  }
}

post

Move one or more agents (assignments) into a folder, or to the root level.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Body

application/json

agent_idsstring · uuid[] · min: 1Required

IDs of the agents (assignments) to move. Must be unique.

folder_idstring · uuid · nullableRequired

Destination folder ID. Pass null to move the agents to the root level.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Responses

200

Default Response

application/json

successbooleanRequired

Always true on success

moved_countnumberRequired

Number of agents that were moved

400

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

post

/v1/agent-folders/move-agents

HTTPcURLJavaScriptPython

POST /v1/agent-folders/move-agents HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "agent_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "folder_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "success": true,
  "moved_count": 1
}