Skip to main content
POST
curl

Authorizations

Authorization
string
header
required

An API key (sig_...), or a session token from the web app.

Path Parameters

agentId
string<uuid>
required

The agent's id.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

runId
string<uuid>
required

The run's id.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

Response

The rescore is queued; the run as it stands.

object
enum<string>
required
Available options:
run
id
string<uuid>
required
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

status
enum<string>
required

queued, running, then complete, refused (budget) or failed. An automatic run over the budget waits in awaiting_approval for a person.

Available options:
queued,
awaiting_approval,
running,
complete,
refused,
failed
message
string | null
required

The latest status message: what the budget covered, or why it refused or failed.

kind
enum<string>
required

A calibration run plays each test 3 times to decide whether it gates.

Available options:
run,
calibration
trigger
enum<string> | null
required

Who started it: a person, Signal on a new version, or an API key.

Available options:
manual,
auto,
ci,
null
version
integer
required

The agent version played.

testSetId
string<uuid> | null
required
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

testIds
string<uuid>[]
required

The tests requested, in order.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
personas
string[] | null
required

The personas requested; null means each test's own caller.

repeats
enum<number> | null
required

3: every cell runs three times and reports k of 3.

Available options:
3
shadowAgentId
string<uuid> | null
required

Set when the run played a shadow copy of the version.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

progress
object
required

Cells finished of cells to play.

cells
object
required

Fewer runnable than requested means the budget covered part of the run; the rest are not run.

summary
object
required
Example:
cost
object
required

Estimated spend.

approvedAt
string<date-time> | null
required

When a person approved an automatic run that was over the budget.

Example:

"2026-10-02T14:03:07.120Z"

createdBy
string | null
required

Who started it: a user id, or key: for an API key.

createdAt
string<date-time>
required
Example:

"2026-10-02T14:03:07.120Z"

updatedAt
string<date-time>
required
Example:

"2026-10-02T14:03:07.120Z"