Eval runs

Read an eval authoring job

Progress and drafts for a job started by cases/generate or cases/import. Poll this after a 202, then commit the job once its status is completed.

get/projects/{projectId}/eval-suites/{suiteId}/authoring/{jobId}

Request

Base URL
https://app.mcpjam.com/api/v1
Auth
HTTP bearer
TypeScript
https://skmtc.dev/mcpjam/apis/mcpjam-api/docs/projects/:projectId/eval-suites/:suiteId/authoring/:jobId/get.ts
A function with typed inputs. Its response is checked against the schema.

projectIdstring required

ID of the hosted project that contains the server.

suiteIdstring required

Eval suite ID, as returned by POST /eval-runs.

jobIdstring required

The job id returned by cases/generate or cases/import.

The authoring job.

jobIdstring required

projectIdstring

suiteIdstring

source'markdown' | 'generation' | 'agent' | 'import'

How the job was started. markdown is the in-app upload, whose drafts a person reviews — it cannot be committed through this API.

status'pending' | 'completed' | 'failed' | 'cancelled' required

phase'prepare' | 'plan' | 'draft' | 'validate' | 'publish'

errorstring nullable

warningsstring[]

draftsobject[]

The cases authored so far. A draft carrying unresolved blocking issues or proposed additions is skipped by a commit and left for review.