Skip to main content
GET
Read an eval authoring job

Authorizations

Authorization
string
header
required

MCPJam API key (sk_…). Create one at Settings → API keys. Guest sessions cannot use the API, and API keys cannot manage other API keys.

Path Parameters

projectId
string
required

ID of the hosted project that contains the server.

suiteId
string
required

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

jobId
string
required

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

Response

The authoring job.

jobId
string
required
status
enum<string>
required
Available options:
pending,
completed,
failed,
cancelled
projectId
string
suiteId
string
source
enum<string>

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

Available options:
markdown,
generation,
agent,
import
phase
enum<string>
Available options:
prepare,
plan,
draft,
validate,
publish
error
string | null
warnings
string[]
drafts
object[]

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