Skip to main content
GET
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.

Path Parameters

suite_id
string
required

Query Parameters

suite_version
integer

Restrict the board to one suite version. Omit to aggregate every version, which mixes task sets — prefer pinning it when the suite has more than one.

Required range: 1 <= x <= 2147483647
metric
string
default:reward

The scores key to average into accuracy. Defaults to reward, what the harness writes for a pass/fail task. Matched as a single top-level key, so reward.avg looks up the literal key.

Maximum string length: 128
Pattern: ^[\w.-]+$
agent
string

Restrict to one agent name.

Maximum string length: 128
model
string

Restrict to one model.

Maximum string length: 255
limit
integer
default:100

Maximum rows returned.

Required range: 1 <= x <= 200

Response

200 - application/json

OK

object
any
required
suite_id
string
required
suite_version
integer | null
required

The version this board was restricted to, or null when it spans every version.

Required range: -9007199254740991 <= x <= 9007199254740991
metric
string
required

The scores key accuracy averages. Echoed back so a board rendered from a non-default metric is self-describing.

data
object[]
required

Rows ordered by accuracy descending, nulls last, then by agent, model, and effort.