Run An Evaluation

Route: POST /api/skills/:id/evaluations/run

Auth: api_key_or_access_token

• user permission: ai.use
• API-key scope: evaluations:write

Response schema: skillEvaluationRunSchema

Related

• list cases: GET /api/skills/:id/evaluation-cases
• create case: POST /api/skills/:id/evaluation-cases
• poll result: GET /api/skills/:id/evaluations/:evaluationRunId

Boundary note

Evaluation results may carry draftRunId and publishedRunId, but the current public docs do not promise /api/runs/:id as a public follow-up inspection route.

See also

• Evaluations
• SDK Evaluations
• Public Boundary