---
title: "List agents"
method: GET
path: "/v1/projects/{project_id}/agents"
tags: ["agents"]
---

# List agents

`GET /v1/projects/{project_id}/agents`

## Request

- Base URL: `https://api.connic.co`
- URL: `https://api.connic.co/v1/projects/{project_id}/agents`
- Auth: HTTP bearer

Agents come from deployments and names that have historical runs in this environment. Each item includes deployment status, run and queue counts, last activity, configuration hints (type, source path), and whether an inbound or sync connector is attached to the known agent.

Required permission: `agents.view`.

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `environment_id` string, uuid, required: Target environment UUID
- `include_variants` boolean: Include A/B variant agents as separate items

## Response `200`

Successful Response

- PublicAgentListItemResponse[]
  - `name` string, required
  - `is_active` boolean, required: Whether the agent is part of the environment's active deployment.
  - `voice_enabled` boolean, required: Whether the agent has a voice configuration.
  - `type` string, required: `llm`, `sequential` (runs other agents in order) or `tool` (runs one tool directly).
  - `total_runs` integer, required: All runs of the agent in this environment.
  - `active_runs` integer, required: Runs currently executing.
  - `queued_runs` integer, required: Runs waiting in the queue.
  - `last_running` string, date-time, nullable, required: Start time of the agent's most recent run. Null when no run has started.
  - `status` 'running' | 'idle', required: `running` while at least one run is executing, otherwise `idle`.
  - `source_path` string, nullable, required: Path of the agent's YAML file in your code. Null for agents only known from past runs.
  - `has_inbound_connector` boolean, required: Whether an inbound or sync connector is linked to the agent, including paused connectors.
  - `test_variants` string[], required: A/B test variants deployed for this agent, from agent names of the form `<agent>-test-<variant>`.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The API key lacks the required permission or access to the environment.
- `422`: Validation Error
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/connic/apis/connic-api.md) · [All operations](https://skmtc.dev/connic/apis/connic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/connic/apis/connic-api/revisions/482932da5fbe?raw)