agents

List agents

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.

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

Path parameters

project_idstring uuid required

ID of the project the API key belongs to.

Query parameters

environment_idstring uuid required

Target environment UUID

include_variantsboolean

Include A/B variant agents as separate items

Response

Successful Response

namestring required
is_activeboolean required

Whether the agent is part of the environment's active deployment.

voice_enabledboolean required

Whether the agent has a voice configuration.

typestring required

llm, sequential (runs other agents in order) or tool (runs one tool directly).

total_runsinteger required

All runs of the agent in this environment.

active_runsinteger required

Runs currently executing.

queued_runsinteger required

Runs waiting in the queue.

last_runningstring 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_pathstring nullable required

Path of the agent's YAML file in your code. Null for agents only known from past runs.

has_inbound_connectorboolean required

Whether an inbound or sync connector is linked to the agent, including paused connectors.

test_variantsstring[] required

A/B test variants deployed for this agent, from agent names of the form <agent>-test-<variant>.

Changes

No recorded changes to this operation across all 2 revisions of this API.