Get TaskAgent Eval Run

GET

/org/:org_id/project/:project_id/task-agent/:task_agent_id/eval/run/:task_agent_eval_run_id

GET

/api/v1/org/:org_id/project/:project_id/task-agent/:task_agent_id/eval/run/:task_agent_eval_run_id

$ curl https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/task-agent/task_agent_id/eval/run/task_agent_eval_run_id \
>      -H "Authorization: Bearer <token>"

1 {
2   "id": "0190e234-1111-2222-3333-444444444444",
3   "task_agent_id": "019df849-e106-3301-5894-291b4c9c6cab",
4   "project_id": "0190a234-9876-5432-10ab-cdef01234567",
5   "candidate_revision_id": "019929cf-f316-196f-3bf9-118b22da0c3c",
6   "status": "completed",
7   "pass_count": 1,
8   "fail_count": 1,
9   "error_count": 0,
10   "created": "2026-07-27T18:54:27.451807Z",
11   "modified": "2026-07-27T18:54:28.185742Z",
12   "judge_model": {
13     "name": "gpt-4o-mini",
14     "provider": "OpenAI"
15   },
16   "task_agent_run_ids": [
17     "0190b234-1111-2222-3333-444444444444",
18     "0190b234-5555-6666-7777-888888888888"
19   ],
20   "pass_rate": 0.5,
21   "eval_set_id": "0190d234-1111-2222-3333-444444444444",
22   "started_at": "2026-07-27T18:54:28.153043Z",
23   "completed_at": "2026-07-27T18:54:37.298606Z",
24   "last_activity_at": "2026-07-27T18:54:37.298606Z",
25   "created_by_user_id": "0190c234-1111-2222-3333-444444444444",
26   "metrics": {
27     "token_cost": {
28       "reference_avg": 266,
29       "candidate_avg": 618,
30       "delta_pct": 132.33
31     },
32     "charged_credits": {
33       "reference_avg": 2,
34       "candidate_avg": 1,
35       "delta_pct": -50
36     },
37     "duration_ms": {
38       "reference_avg": 2945,
39       "candidate_avg": 7250,
40       "delta_pct": 146.18
41     }
42   },
43   "results": [
44     {
45       "id": "0190e234-dddd-eeee-ffff-000011112222",
46       "eval_run_id": "0190e234-1111-2222-3333-444444444444",
47       "eval_case_id": "0190e234-9999-aaaa-bbbb-cccccccccccc",
48       "reference_run_id": "0190b234-1111-2222-3333-444444444444",
49       "judge_input_tokens": 384,
50       "judge_output_tokens": 54,
51       "is_error": false,
52       "created": "2026-07-27T18:54:37.208994Z",
53       "candidate_run_id": "0190e234-5555-6666-7777-888888888888",
54       "verdict": "fail",
55       "reasoning": "The Candidate output does not provide a classification for the support request, which is a key requirement of the user input.",
56       "metrics": {
57         "reference": {
58           "total_tokens": 266,
59           "charged_credits": "2.00",
60           "duration_ms": 2945
61         },
62         "candidate": {
63           "total_tokens": 618,
64           "charged_credits": "1.00",
65           "duration_ms": 7250
66         }
67       }
68     }
69   ]
70 }

Get TaskAgent eval run detail, including verdicts, aggregate metrics, and per-result run metrics when the underlying source rows still exist. The response includes the immutable custom judge configuration when one was supplied; its text is visible under these existing run-detail authorization rules. Encrypted reference and candidate output snapshots are not exposed.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

org_idstringRequiredformat: "uuid"

The organization ID

project_idstringRequiredformat: "uuid"

The project ID

task_agent_idstringRequiredformat: "uuid"

The task agent ID

task_agent_eval_run_idstringRequiredformat: "uuid"

The TaskAgent eval run ID

Response

TaskAgent eval run detail

idstringformat: "uuid"

task_agent_idstringformat: "uuid"

project_idstringformat: "uuid"

candidate_revision_idstringformat: "uuid"

statusenum

Status of a TaskAgent eval run.

pass_countinteger

fail_countinteger

error_countinteger

createdstring

modifiedstring

judge_modelobject

task_agent_run_idslist of stringsRead-only

pass_ratedouble or nullRead-only

eval_set_idstring or nullOptionalformat: "uuid"

started_atstring or nullOptional

completed_atstring or nullOptional

last_activity_atstring or nullOptional

error_messagestring or nullOptional

created_by_user_idstring or nullOptionalformat: "uuid"

judge_configobject or nullOptional

metricsobject or nullOptional

resultslist of objectsOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error