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"

Body

application/json
testIds
string<uuid>[]
required

The tests to calibrate. Every id must be one of this agent's tests: an unknown id is 404 tests_not_found and an archived one 400 tests_archived, both naming the ids, and nothing runs.

Minimum array length: 1
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}$

Response

The calibration runs, queued, and the tests skipped.

object
enum<string>
required
Available options:
calibration
runs
object[]
required

The calibration runs started (kind "calibration"), one per version the tests are calibrated on. Poll each with GET .../runs/{runId}; each test's calibration says what they decided.

skipped
object[]
required

Tests asked for that were not calibrated, and why: the version is not known or not stored, or the budget or the plan does not cover them.