curl "https://app.runtm.com/api/cloud/sessions/a6414511-4430-4e1f-8c51-8ea8824dadec/grade" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api session grade a6414511-4430-4e1f-8c51-8ea8824dadec
{
"graded": true,
"success": true,
"reason": "Lists were built, deduped, and posted for approval with the hypothesis quoted.",
"task": "weekly-lists",
"tags": {},
"criteria_version": 2,
"grader_model": "claude-sonnet",
"graded_at": "2026-07-27T18:41:12Z"
}
{
"graded": false
}
Activity
Session Grade
The latest evaluation verdict for a run
GET
/
api
/
sessions
/
{session_id}
/
grade
curl "https://app.runtm.com/api/cloud/sessions/a6414511-4430-4e1f-8c51-8ea8824dadec/grade" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api session grade a6414511-4430-4e1f-8c51-8ea8824dadec
{
"graded": true,
"success": true,
"reason": "Lists were built, deduped, and posted for approval with the hypothesis quoted.",
"task": "weekly-lists",
"tags": {},
"criteria_version": 2,
"grader_model": "claude-sonnet",
"graded_at": "2026-07-27T18:41:12Z"
}
{
"graded": false
}
Returns the run grader’s verdict for one session: whether the run met its agent’s objective, the reason, and which rubric version produced the grade. Runs are graded automatically after completion when their roster agent has
evaluator_criteria set. Ungraded sessions return {"graded": false}.
Org members can read grades for any session in the organization.
Required scope: activity:read
Path Parameters
string
required
The session ID.
Response
boolean
Whether a verdict exists. When false, no other fields are present.
boolean
Whether the run met the objective.
string
The grader’s explanation.
string | null
The task label the grader assigned, matching keys in the agent’s
economics.tasks.object
Additional labels the grader attached.
integer
Which rubric version produced this grade.
string
The model that graded the run.
string
When the grade was recorded.
curl "https://app.runtm.com/api/cloud/sessions/a6414511-4430-4e1f-8c51-8ea8824dadec/grade" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api session grade a6414511-4430-4e1f-8c51-8ea8824dadec
{
"graded": true,
"success": true,
"reason": "Lists were built, deduped, and posted for approval with the hypothesis quoted.",
"task": "weekly-lists",
"tags": {},
"criteria_version": 2,
"grader_model": "claude-sonnet",
"graded_at": "2026-07-27T18:41:12Z"
}
{
"graded": false
}