Skip to main content
GET
/
v2
/
teams
/
{teamId}
/
agents
List Agents
curl --request GET \
  --url https://api.duvo.ai/v2/teams/{teamId}/agents \
  --header 'Authorization: Bearer <token>'
{
  "agents": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "slack_enabled": true,
      "microsoft_teams_enabled": true,
      "agentic_memory_enabled": true,
      "team_id": "<string>",
      "thread_id": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "last_run_at": "<string>",
      "latest_build": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "copilot_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "config": {
          "data": {
            "model": "<string>",
            "tools": "<unknown>",
            "input": "<string>",
            "files": [],
            "skills": [],
            "temperature": 1,
            "max_output_tokens": 1,
            "top_p": 0.5,
            "store": true,
            "text": {
              "format": {}
            }
          }
        },
        "status": "<string>",
        "revision_number": 123,
        "parent_build_id": "<string>",
        "created_by": "<string>",
        "created_at": "<string>",
        "updated_at": "<string>",
        "revision_name": "<string>",
        "revision_description": "<string>",
        "created_by_name": "<string>",
        "schedules": [
          {
            "id": "<string>",
            "build_id": "<string>",
            "agent_id": "<string>",
            "user_id": "<string>",
            "enabled": true,
            "time": "<string>",
            "timezone": "<string>",
            "day": "<string>",
            "day_of_month": 123,
            "cron": "<string>",
            "source": "<string>",
            "task": "<string>",
            "recurring": true,
            "created_at": "<string>",
            "updated_at": "<string>",
            "user_name": "<string>",
            "user_email": "<string>"
          }
        ]
      },
      "integration_configs": [
        {
          "id": "<string>",
          "integration_id": "<string>",
          "integration_type": "<string>",
          "integration_name": "<string>",
          "created_at": "<string>",
          "icon_url": "<string>",
          "is_connected": true
        }
      ],
      "folder_id": "<string>",
      "pinned_at": "<string>",
      "created_by": {
        "id": "<string>",
        "name": "<string>",
        "email": "<string>"
      },
      "updated_by": {
        "id": "<string>",
        "name": "<string>",
        "email": "<string>"
      },
      "user_triggers": {
        "slack_mention": true,
        "slack_channel": true,
        "teams_mention": true
      },
      "case_trigger_enabled": true,
      "case_trigger_has_conflict": true,
      "case_trigger_conflicting_agents": [
        {
          "id": "<string>",
          "name": "<string>"
        }
      ],
      "case_queue_name": "<string>"
    }
  ],
  "total": 0,
  "limit": 0,
  "offset": 0
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
teamId
string
required

Query Parameters

​
include_schedules
enum<string>
default:false

Include the authenticated user's schedules for each agent in the response. Schedules are per-user, so this only returns schedules the current user owns.

Available options:
true,
false
​
limit
integer
default:20

Number of agents per page (1-100, default 20)

Required range: 1 <= x <= 100
​
offset
integer

Number of agents to skip

Required range: 0 <= x <= 9007199254740991

Response

Default Response

​
agents
object[]
required
​
total
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
​
limit
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
​
offset
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991