Read one hosted drill run

Read one hosted drill run

cURL

curl --request GET \
  --url https://api.firedrill.run/v1/projects/{projectId}/runs/{hostedRunId} \
  --header 'Authorization: Bearer <token>'

200

{
  "schemaVersion": 1,
  "hostedRunId": "<string>",
  "evidenceBundleId": "<string>",
  "organizationId": "<string>",
  "projectId": "<string>",
  "environmentId": "<string>",
  "sessionId": "<string>",
  "buildHash": "<string>",
  "request": {
    "runId": "<string>",
    "drillId": "<string>",
    "seed": "<string>",
    "trial": 4503599627370495,
    "trialCount": 4503599627370495,
    "attempt": 4503599627370495,
    "attemptLimit": 4503599627370495
  },
  "leaseGeneration": 4503599627370495,
  "revision": 4503599627370495,
  "state": "created",
  "deadlineAtMs": 0,
  "evidenceRetentionMs": 4503599627370495,
  "createdAtMs": 0,
  "updatedAtMs": 0,
  "rerunOfHostedRunId": "<string>",
  "identity": {
    "runId": "<string>",
    "worldInstanceId": "<string>",
    "drillId": "<string>",
    "targetId": "<string>",
    "buildHash": "<string>",
    "packageLockHash": "<string>",
    "seed": "<string>",
    "trial": 4503599627370495,
    "trialCount": 4503599627370495,
    "attempt": 1,
    "attemptLimit": 1,
    "scenarioId": "<string>",
    "setupHash": "<string>"
  },
  "termination": {
    "schemaVersion": 1,
    "outcome": "runner_failed",
    "reason": "<string>",
    "requestedAtMs": 0
  },
  "pendingInteraction": {
    "schemaVersion": 1,
    "interaction": {
      "id": "<string>",
      "afterStartUs": 0,
      "actorId": "<string>",
      "task": {
        "instruction": "<string>",
        "input": "<unknown>"
      }
    },
    "scheduledAtVirtualUs": 0,
    "startedAtVirtualUs": 0,
    "toolCallsAtStart": 0
  },
  "result": {
    "schemaVersion": 1,
    "identity": {
      "runId": "<string>",
      "worldInstanceId": "<string>",
      "drillId": "<string>",
      "targetId": "<string>",
      "buildHash": "<string>",
      "packageLockHash": "<string>",
      "seed": "<string>",
      "trial": 4503599627370495,
      "trialCount": 4503599627370495,
      "attempt": 1,
      "attemptLimit": 1,
      "scenarioId": "<string>",
      "setupHash": "<string>"
    },
    "startedAtVirtualUs": 0,
    "finishedAtVirtualUs": 0,
    "bindingEvidence": "not_checked",
    "worldConsistency": "atomic",
    "interactions": [
      {
        "schemaVersion": 1,
        "interactionId": "<string>",
        "actorId": "<string>",
        "task": {
          "instruction": "<string>",
          "input": "<unknown>"
        },
        "scheduledAtVirtualUs": 0,
        "startedAtVirtualUs": 0,
        "finishedAtVirtualUs": 0,
        "bindingEvidence": "not_checked",
        "targetResult": {
          "schemaVersion": 1,
          "status": "completed",
          "attachments": [],
          "output": "<unknown>",
          "error": {
            "schemaVersion": 1,
            "code": "<string>",
            "source": "framework",
            "message": "<string>",
            "retryable": true,
            "issues": [],
            "correlationId": "<string>",
            "details": {},
            "evidence": {
              "runId": "<string>",
              "sequence": 4503599627370495
            }
          }
        }
      }
    ],
    "checkpoints": [
      {
        "schemaVersion": 1,
        "checkpointId": "<string>",
        "kind": "after_interaction",
        "virtualTimeUs": 0,
        "verdict": "passed",
        "assertionResults": [
          {
            "schemaVersion": 1,
            "assertionId": "<string>",
            "kind": "state.value",
            "status": "passed",
            "gate": true,
            "message": "<string>",
            "expected": "<unknown>",
            "actual": "<unknown>",
            "location": {
              "subject": "state",
              "packageId": "<string>",
              "namespace": "<string>",
              "path": [],
              "rowId": "<string>"
            },
            "diff": {
              "operator": "equals",
              "matched": true,
              "details": {}
            },
            "evidenceSequences": []
          }
        ],
        "interactionId": "<string>"
      }
    ],
    "budgetUsage": {
      "toolCalls": {
        "limit": 4503599627370495,
        "attempted": 0,
        "rejected": 0
      },
      "scheduledEvents": {
        "limit": 4503599627370495,
        "processed": 0,
        "exhausted": true
      }
    },
    "status": "sealed",
    "verdict": "passed",
    "assertionResults": [
      {
        "schemaVersion": 1,
        "assertionId": "<string>",
        "kind": "state.value",
        "status": "passed",
        "gate": true,
        "message": "<string>",
        "expected": "<unknown>",
        "actual": "<unknown>",
        "location": {
          "subject": "state",
          "packageId": "<string>",
          "namespace": "<string>",
          "path": [],
          "rowId": "<string>"
        },
        "diff": {
          "operator": "equals",
          "matched": true,
          "details": {}
        },
        "evidenceSequences": []
      }
    ],
    "evidenceRange": {
      "fromSequence": 4503599627370495,
      "toSequence": 4503599627370495
    },
    "stateHash": "<string>",
    "evidenceHash": "<string>",
    "trajectoryHash": "<string>",
    "setup": {
      "schemaVersion": 1,
      "drillId": "<string>",
      "setup": {
        "tools": {
          "packages": [],
          "behaviorOverrides": []
        },
        "bindings": {
          "environment": {}
        },
        "scenario": {
          "actors": [],
          "state": [],
          "faults": [],
          "initialEvents": [],
          "virtualTimeUs": 0,
          "toolOverrides": [
            {
              "id": "<string>",
              "operation": {
                "packageId": "<string>",
                "operationId": "<string>"
              },
              "outcome": {
                "kind": "return",
                "value": "<unknown>"
              },
              "when": {
                "arguments": {},
                "actorId": "<string>"
              },
              "times": 4503599627370495
            }
          ]
        }
      },
      "setupHash": "<string>"
    },
    "capture": {
      "schemaVersion": 1,
      "policies": {
        "logs": "off",
        "screenshots": "off",
        "video": "off",
        "files": "off"
      },
      "attachments": [
        {
          "kind": "log",
          "policy": "always",
          "attachment": {
            "schemaVersion": 1,
            "kind": "file",
            "id": "<string>",
            "name": "<string>",
            "mediaType": "<string>",
            "bytes": 33554432,
            "hash": "<string>",
            "redaction": {
              "status": "not_applied",
              "note": null
            }
          },
          "interactionId": "<string>"
        }
      ],
      "errors": [
        {
          "code": "<string>",
          "message": "<string>",
          "kind": "log",
          "interactionId": "<string>"
        }
      ],
      "discarded": {
        "logs": 0,
        "screenshots": 0,
        "video": 0,
        "files": 0
      }
    }
  },
  "failure": {
    "schemaVersion": 1,
    "code": "<string>",
    "source": "framework",
    "message": "<string>",
    "retryable": true,
    "issues": [],
    "correlationId": "<string>",
    "details": {},
    "evidence": {
      "runId": "<string>",
      "sequence": 4503599627370495
    }
  },
  "finishedAtMs": 0
}

Authorizations

Authorization · string · header · required

Opaque control credential

Path Parameters

projectId · string · required

Pattern: ^prj_[0-9a-z]{12,32}$

hostedRunId · string · required

Pattern: ^hrun_[0-9a-z]{12,32}$

Response

200

application/json

Hosted drill run

schemaVersion · enum<number> · required

Available options: 1

hostedRunId · string · required

Pattern: ^hrun_[0-9a-z]{12,32}$

evidenceBundleId · string · required

Pattern: ^evidence_[0-9a-z]{12,32}$

organizationId · string · required

Pattern: ^org_[0-9a-z]{12,32}$

projectId · string · required

Pattern: ^prj_[0-9a-z]{12,32}$

environmentId · string · required

Pattern: ^env_[0-9a-z]{12,32}$

sessionId · string · required

Pattern: ^ses_[0-9a-z]{12,32}$

buildHash · string · required

Pattern: ^sha256:[0-9a-f]{64}$

request · object · required

Show child attributes

leaseGeneration · integer · required

Required range: 0 < x <= 9007199254740991

revision · integer · required

Required range: 0 < x <= 9007199254740991

state · enum<string> · required

Available options: created, awaiting_agent, ready_to_seal, sealed, runner_failed, cancelled, aborted_before_start, orchestration_failed

deadlineAtMs · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

evidenceRetentionMs · integer · required

Required range: 0 < x <= 9007199254740991

createdAtMs · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

updatedAtMs · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

rerunOfHostedRunId · string

Pattern: ^hrun_[0-9a-z]{12,32}$

identity · object

Show child attributes

termination · object

Show child attributes

pendingInteraction · object

Show child attributes

result · object

Option 1

Option 2

Option 3

Show child attributes

failure · object

Show child attributes

finishedAtMs · integer

Required range: -9007199254740991 <= x <= 9007199254740991