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. Use those ids only with the family-specific public inspection routes that are documented for the underlying run type.

See also

• Evaluations
• SDK Evaluations
• Public Boundary