> ## Documentation Index > Fetch the complete documentation index at: https://docs.firedrill.run/llms.txt > Use this file to discover all available pages before exploring further. # Compare two immutable drill-run evidence bundles ## OpenAPI ````yaml /api-reference/openapi.json get /v1/projects/{projectId}/run-comparisons openapi: 3.1.0 info: title: Firedrill Control API version: 1.0.0 description: >- The control plane for drills, drill runs, and the worlds they run in. Errors always carry the canonical envelope; unsafe operations require an Idempotency-Key; long work returns an operation resource. servers: - url: https://api.firedrill.run security: - controlCredential: [] paths: /v1/projects/{projectId}/run-comparisons: get: summary: Compare two immutable drill-run evidence bundles operationId: runs.compare parameters: - name: projectId in: path required: true schema: type: string pattern: ^prj_[0-9a-z]{12,32}$ - name: baselineHostedRunId in: query required: true schema: type: string pattern: ^hrun_[0-9a-z]{12,32}$ - name: candidateHostedRunId in: query required: true schema: type: string pattern: ^hrun_[0-9a-z]{12,32}$ responses: '200': description: Hosted drill-run comparison content: application/json: schema: $ref: '#/components/schemas/HostedRunComparison' default: description: Canonical error envelope content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' components: schemas: HostedRunComparison: type: object properties: schemaVersion: type: number enum: - 1 compatibility: type: object properties: status: type: string enum: - exact_inputs - descriptive_only - incompatible canAttributeBehaviorChange: type: boolean differences: type: array items: type: string enum: - drill - scenario - target - seed - build - package_lock - runtime_controls explanation: type: string minLength: 1 maxLength: 2000 required: - status - canAttributeBehaviorChange - differences - explanation additionalProperties: false outcome: type: string enum: - unchanged - changed - not_comparable baseline: type: object properties: hostedRunId: type: string pattern: ^hrun_[0-9a-z]{12,32}$ evidenceBundleId: type: string pattern: ^evidence_[0-9a-z]{12,32}$ runId: type: string pattern: ^run_[A-Za-z0-9][A-Za-z0-9_-]{5,95}$ status: type: string enum: - sealed - runner_failed - cancelled verdict: type: string enum: - passed - failed - inconclusive drillId: type: string minLength: 1 maxLength: 96 scenarioId: type: string minLength: 1 maxLength: 96 targetId: type: string minLength: 1 maxLength: 96 seed: type: string pattern: ^(0|[1-9]\d{0,19})$ buildHash: type: string pattern: ^sha256:[0-9a-f]{64}$ packageLockHash: type: string pattern: ^sha256:[0-9a-f]{64}$ stateHash: type: string pattern: ^sha256:[0-9a-f]{64}$ trajectoryHash: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - hostedRunId - evidenceBundleId - runId - status - drillId - targetId - seed - buildHash - packageLockHash additionalProperties: false candidate: type: object properties: hostedRunId: type: string pattern: ^hrun_[0-9a-z]{12,32}$ evidenceBundleId: type: string pattern: ^evidence_[0-9a-z]{12,32}$ runId: type: string pattern: ^run_[A-Za-z0-9][A-Za-z0-9_-]{5,95}$ status: type: string enum: - sealed - runner_failed - cancelled verdict: type: string enum: - passed - failed - inconclusive drillId: type: string minLength: 1 maxLength: 96 scenarioId: type: string minLength: 1 maxLength: 96 targetId: type: string minLength: 1 maxLength: 96 seed: type: string pattern: ^(0|[1-9]\d{0,19})$ buildHash: type: string pattern: ^sha256:[0-9a-f]{64}$ packageLockHash: type: string pattern: ^sha256:[0-9a-f]{64}$ stateHash: type: string pattern: ^sha256:[0-9a-f]{64}$ trajectoryHash: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - hostedRunId - evidenceBundleId - runId - status - drillId - targetId - seed - buildHash - packageLockHash additionalProperties: false changes: type: object properties: verdictChanged: type: boolean stateChanged: type: boolean trajectoryChanged: type: boolean operationCounts: type: array items: type: object properties: subject: type: string minLength: 1 maxLength: 1024 baseline: type: integer minimum: -9007199254740991 maximum: 9007199254740991 candidate: type: integer minimum: -9007199254740991 maximum: 9007199254740991 delta: type: integer minimum: -9007199254740991 maximum: 9007199254740991 baselineErrors: type: integer minimum: -9007199254740991 maximum: 9007199254740991 candidateErrors: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - subject - baseline - candidate - delta - baselineErrors - candidateErrors additionalProperties: false stateChangeCounts: type: array items: type: object properties: subject: type: string minLength: 1 maxLength: 1024 baseline: type: integer minimum: -9007199254740991 maximum: 9007199254740991 candidate: type: integer minimum: -9007199254740991 maximum: 9007199254740991 delta: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - subject - baseline - candidate - delta additionalProperties: false eventCounts: type: array items: type: object properties: subject: type: string minLength: 1 maxLength: 1024 baseline: type: integer minimum: -9007199254740991 maximum: 9007199254740991 candidate: type: integer minimum: -9007199254740991 maximum: 9007199254740991 delta: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - subject - baseline - candidate - delta additionalProperties: false assertions: type: array items: type: object properties: checkpointId: type: string minLength: 1 maxLength: 512 assertionId: type: string minLength: 1 maxLength: 512 baseline: type: string enum: - passed - failed - inconclusive - invalid candidate: type: string enum: - passed - failed - inconclusive - invalid actualChanged: type: boolean expectedChanged: type: boolean required: - checkpointId - assertionId - actualChanged additionalProperties: false interactions: type: array items: type: object properties: interactionId: type: string minLength: 1 maxLength: 512 baseline: type: string minLength: 1 maxLength: 128 candidate: type: string minLength: 1 maxLength: 128 required: - interactionId additionalProperties: false required: - verdictChanged - operationCounts - stateChangeCounts - eventCounts - assertions - interactions additionalProperties: false required: - schemaVersion - compatibility - outcome - baseline - candidate - changes additionalProperties: false ErrorEnvelope: type: object properties: code: type: string pattern: ^(control|world)\.[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$ message: type: string minLength: 1 correlationId: type: string minLength: 1 retryable: type: boolean retryAfterMs: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 operationId: type: string source: type: string enum: - platform - simulated_provider issues: type: array items: type: object properties: path: type: string code: type: string message: type: string required: - path - code - message additionalProperties: false details: type: object propertyNames: type: string additionalProperties: {} evidence: type: object properties: sessionId: type: string runId: type: string journalSeq: type: integer minimum: 0 maximum: 9007199254740991 buildHash: type: string additionalProperties: false required: - code - message - correlationId - retryable - source additionalProperties: true securitySchemes: controlCredential: type: http scheme: bearer description: Opaque control credential ````