agents

Get agent

Returns the agent's configuration from the active deployment (null when the active deployment does not contain it), run statistics, token usage and cost, linked connectors, and average scores of its judges in the given environment. Statistics and judge averages cover runs queued in the selected window (the last 30 days by default), narrowed by the run filters.

Required permission: agents.view.

get/v1/projects/{project_id}/agents/{agent_name}

Request

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

Path parameters

project_idstring uuid required

ID of the project the API key belongs to.

agent_namestring required

Agent name as defined in the agent's YAML file.

Query parameters

environment_idstring uuid required

Target environment UUID

time_range'24h' | '7d' | '30d' | '90d' | 'today' | 'this_month' | 'last_month' | 'this_year' | 'all' nullable

Preset statistics window ending now, a calendar period in UTC, or all for no time limit. Ignored when start_date is set.

start_datestring date-time nullable

Custom statistics window start; overrides time_range.

end_datestring date-time nullable

Custom statistics window end; used only with start_date, which is open-ended without it.

deployment_idstring uuid nullable

Only include runs executed by this deployment.

status_filterRunStatus[] nullable

Restrict stats to statuses

guardrail_outcomestring[] nullable

Restrict stats to guardrail outcomes

test_namestring[] nullable

A/B test variant names; use base for runs without a variant

exclude_test_runsboolean

Exclude runs with a test name

searchstring nullable

Run search text or filter expression, as in GET /runs.

convert_costs_to'EUR' | 'USD' nullable

Convert token costs to EUR or USD at the daily ECB reference rate of each model call

Response

Successful Response

Changes

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