Sign in

v106

OpenAPI 3.1.0raw.githubusercontent.com2026-08-02160524464.6 KB
Human-in-the-Loop

Start Run Pair

Starts pairing with exactly one selected active API-mode agent target.

post/api/v1/runs/{id}/pair

Path parameters

idstring required

Unique run identifier (ULID).

Request body

stage_idstring required

Example request

{
  "stage_id": "code@1"
}

Response

Pair mode installed for the selected target

pair_idstring required

Durable run pair identifier.

run_idstring required
status'active' | 'ended' | 'failed' required
started_atstring date-time required
ended_atstring date-time nullable
failure_reasonstring nullable

Example response

{
  "pair_id": "01HZX6M29F1CD5YYMHT1F5D7WQ",
  "target": {
    "stage_id": "code@1",
    "node_label": "Code"
  }
}