Skip to main content
POST
Authenticate and record an eval start

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

Project id, or default to resolve the authenticated organization's Default project.

Body

application/json
runStartId
string<uuid>
required
surface
enum<string>
required
Available options:
sdk,
cli,
vitest
clientVersion
string
required
Required string length: 1 - 64
providers
string[]
required
Maximum array length: 32
Pattern: ^[a-z0-9_-]{1,64}$
usedClientProfile
required
plannedIterations
integer
required
Required range: 0 <= x <= 9007199254740991

Response

Authenticated start receipt. Identical retries return the same receipt.

ok
enum<boolean>
required
Available options:
true
runStartId
string<uuid>
required
organizationId
string
required
projectId
string
required