Skip to main content
POST
Python (SDK)

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Body

application/json
suite_id
string
required
Minimum string length: 1
models
string[]
required
Required array length: 1 - 20 elements
Required string length: 1 - 255
suite_version
integer
Required range: 1 <= x <= 2147483647
task_ids
string[]
Minimum array length: 1
judge_model
string
embedding_model
string
generation
object
generation_concurrency
integer
Required range: 1 <= x <= 256
concurrency
integer
Required range: 1 <= x <= 256
grader_concurrency
integer
Required range: 1 <= x <= 256
max_samples_per_task
integer
Required range: 1 <= x <= 9007199254740991
max_workflow_sample_activities
integer

Maximum sample-stage activity reservations per Temporal workflow execution before continuing as new.

Required range: 100 <= x <= 50000
metadata
object

Response

200 - application/json

OK

id
string
required
object
any
required
suite_id
string
required
suite_version
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
suite_version_id
string
required
org_id
string
required

The org that owns this run.

team_id
string
required

The team that owns this run.

status
enum<string>
required
Available options:
queued,
in_progress,
finalizing,
completed,
failed,
cancelling,
cancelled
models
string[]
required
task_ids
string[] | null
required
judge_model
string | null
required
embedding_model
string | null
required
generation
object
required
request_counts
object
required
metrics
object | null
required
error
object | null
required
artifact_file_ids
string[]
required
metadata
object
required
created_at
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
started_at
integer | null
required
Required range: -9007199254740991 <= x <= 9007199254740991
completed_at
integer | null
required
Required range: -9007199254740991 <= x <= 9007199254740991
cancelled_at
integer | null
required
Required range: -9007199254740991 <= x <= 9007199254740991
failed_at
integer | null
required
Required range: -9007199254740991 <= x <= 9007199254740991