runs

Get run

Returns one run with its input, output, error, execution trace, token usage and cost, connector, trigger details and run context. Token usage and cost cover the agent's own model calls; judge evaluations of the run are listed by GET /runs/{run_id}/judge-runs.

Required permission: runs.view.

get/v1/projects/{project_id}/runs/{run_id}

Request

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

Path parameters

project_idstring uuid required

ID of the project the API key belongs to.

run_idstring uuid required

Run ID from GET /runs.

Query parameters

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

idstring uuid required
agent_namestring required

Base agent name; runs handled by an A/B variant are stored under the base name.

test_namestring nullable

A/B test variant that handled the run, or the test case name for deploy_gate runs; null for runs of the base agent.

ab_test_idsstring[]

IDs of the A/B tests this run was counted in.

status'scheduled' | 'queued' | 'started' | 'awaiting_approval' | 'completed' | 'failed' | 'cancelled' | 'blocked' required

Run state: scheduled until its start time, queued, started while executing, awaiting_approval while paused for a human decision, then completed, failed or cancelled.

inputstring nullable

Run input as text, with the environment's redacted keys masked; null after the run is deleted.

outputstring nullable

Final agent output, with the environment's redacted keys masked; null until the run finishes and after it is deleted.

errorstring nullable

Failure or cancellation message, if any; null after the run is deleted.

queued_atstring date-time required

When the run was created.

started_atstring date-time nullable

When execution began; null until the run starts.

ended_atstring date-time nullable

When the run reached a final status; null while it is active.

duration_msnumber nullable

Execution time in milliseconds, excluding time spent waiting for approvals or child runs; null until the run ends.

data_deleted_atstring date-time nullable

When the run's content and trace were deleted; null if they were not. Status, usage and cost remain.

can_delete_databoolean

True when the run and its background processing (usage accounting, judge evaluations, outbound deliveries) have finished, so it can be deleted.

scheduled_atstring date-time nullable

When a scheduled run is due to start; null for runs queued immediately.

queued_reasonstring nullable

Why a queued run has not started yet, for example concurrency_wait, credit_exhausted or budget_limit_exceeded:<spend alert ID>. Null once the run starts.

triggered_bystring nullable

ID of the run whose agent started this run; older runs may hold a free-text value instead.

trigger_source'manual' | 'connector' | 'agent' | 'deploy_gate'

How a run was started: manual by a user, connector by an inbound connector event, agent by another agent, or deploy_gate as a deployment test run.

deployment_idstring uuid nullable

ID of the deployment that ran this run; null until the run is picked up.

run_contextobject nullable

Context values stored by the run's middleware and tools, with the environment's redacted keys masked; null after the run is deleted.

Changes

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