> ## 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.

# Read batch distributions

> Requires `read`. Returns descriptive repeated-trial distributions, exact-check denominators, declared metrics and compatible groups. Jev fractional provider scores remain separate from ordinal levels. No success probability or universal winner is inferred.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/batches/{batchId}/summary
openapi: 3.1.0
info:
  title: Firedrill API
  version: '2026-10-14'
  description: >-
    Authenticated simulation coordination, retained evidence and controlled
    Tools. Your customer-owned runner executes the target. This reference covers
    the documented JSON workflows; Tool-native HTTP routes and MCP methods are
    discovered from the selected Tool. Structural schemas do not replace
    canonical validation or capability checks.
servers:
  - url: https://api.firedrill.run
security:
  - FiredrillCredential: []
tags:
  - name: discovery
    description: Capabilities, authority and structural authoring schemas.
  - name: projects
    description: Projects and their logical environment.
  - name: simulations
    description: Preparation, queued batches and cancellation.
  - name: runs
    description: Individual recorded executions.
  - name: reports
    description: Retained observations, distributions and descriptive comparisons.
  - name: assessment
    description: Optional semantic assessment and authored scenario ranking.
  - name: evidence
    description: Authenticated captured files.
  - name: runner-protocol
    description: Advanced customer-runner coordination; native SDKs manage this protocol.
  - name: scenarios
    description: Immutable retained versions of repository-authored scenarios.
  - name: credentials
    description: Expiring scoped CI credentials.
  - name: authentication
    description: Human-approved sign-in boundaries.
  - name: tools
    description: Tool releases, data, instances and observations.
  - name: tool-connections
    description: Bounded target/manual grants, separate from control authority.
  - name: tool-lifecycle
    description: Epoch-fenced reusable Tool actions and exact-key recovery.
paths:
  /v1/batches/{batchId}/summary:
    get:
      tags:
        - reports
      summary: Read batch distributions
      description: >-
        Requires `read`. Returns descriptive repeated-trial distributions,
        exact-check denominators, declared metrics and compatible groups. Jev
        fractional provider scores remain separate from ordinal levels. No
        success probability or universal winner is inferred.
      operationId: batches_get_summary
      parameters:
        - name: batchId
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 160
        - name: x-fd-read-scope-version
          in: header
          required: false
          schema:
            type: string
            const: 2026-10-16-read-scope.1
          description: >-
            Send all three selected-read headers together. The response echoes
            the confirmed selection.
        - name: x-fd-read-project-id
          in: header
          required: false
          schema:
            type: string
          description: >-
            Your selected project. A resource outside the selected context
            returns 409.
        - name: x-fd-read-environment-id
          in: header
          required: false
          schema:
            type: string
          description: Your selected environment. These headers never grant authority.
      responses:
        '200':
          description: The retained resource or operation response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchSummary'
          headers:
            x-fd-read-scope-version:
              description: >-
                Send all three selected-read headers together. The response
                echoes the confirmed selection.
              schema:
                type: string
                const: 2026-10-16-read-scope.1
            x-fd-read-project-id:
              description: >-
                Your selected project. A resource outside the selected context
                returns 409.
              schema:
                type: string
            x-fd-read-environment-id:
              description: Your selected environment. These headers never grant authority.
              schema:
                type: string
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '410':
          $ref: '#/components/responses/Gone'
        '413':
          $ref: '#/components/responses/PayloadTooLarge'
        '415':
          $ref: '#/components/responses/UnsupportedMediaType'
        '422':
          $ref: '#/components/responses/InvalidInput'
        '429':
          $ref: '#/components/responses/Capacity'
        '500':
          $ref: '#/components/responses/Internal'
        '503':
          $ref: '#/components/responses/Unavailable'
components:
  schemas:
    BatchSummary:
      type: object
      properties:
        schemaVersion:
          type: string
          const: 2026-10-15-comparison.4
        batchId:
          type: string
        scope:
          $ref: '#/components/schemas/ScopeRef'
        snapshotAt:
          type: string
        targetDigest:
          type: string
        targetDisclosure:
          anyOf:
            - $ref: '#/components/schemas/TargetDisclosure'
        populationDisclosure:
          anyOf:
            - $ref: '#/components/schemas/PopulationDisclosure'
        serviceBindingsDigest:
          type: string
        counts:
          $ref: '#/components/schemas/PopulationCounts'
        groups:
          type: array
          items:
            $ref: '#/components/schemas/PopulationSummary'
        notes:
          type: array
          items:
            type: string
      required:
        - schemaVersion
        - batchId
        - scope
        - snapshotAt
        - targetDigest
        - serviceBindingsDigest
        - counts
        - groups
        - notes
    ScopeRef:
      type: object
      properties:
        organizationId:
          type: string
        projectId:
          type: string
        environmentId:
          type: string
      required:
        - organizationId
        - projectId
        - environmentId
    TargetDisclosure:
      type: object
      properties:
        schemaVersion:
          type: string
          const: 2026-10-15-target-metadata.1
        source:
          type: object
          properties:
            state:
              type: string
              enum:
                - unknown
                - selected_files_pinned
                - declared_revision
            revision:
              anyOf:
                - type: 'null'
                - type: string
            contentDigest:
              anyOf:
                - type: 'null'
                - type: string
            dirty:
              type: string
              enum:
                - clean
                - dirty
                - unknown
            verification:
              type: string
              enum:
                - required_at_isolated_execution
                - not_verified
          required:
            - state
            - revision
            - contentDigest
            - dirty
            - verification
        resetCoverage:
          type: object
          properties:
            applicationDatabase:
              type: string
              enum:
                - unknown
                - customer_managed
                - not_reset
                - not_used
            cache:
              type: string
              enum:
                - unknown
                - customer_managed
                - not_reset
                - not_used
            filesystem:
              type: string
              enum:
                - unknown
                - customer_managed
                - not_reset
                - not_used
            conversationMemory:
              type: string
              enum:
                - unknown
                - customer_managed
                - not_reset
                - not_used
            outstandingJobs:
              type: string
              enum:
                - unknown
                - customer_managed
                - not_reset
                - not_used
            browserProfile:
              type: string
              enum:
                - unknown
                - customer_managed
                - not_reset
                - not_used
            externalState:
              type: string
              enum:
                - unknown
                - customer_managed
                - not_reset
                - not_used
          required:
            - applicationDatabase
            - cache
            - filesystem
            - conversationMemory
            - outstandingJobs
            - browserProfile
            - externalState
        automaticTargetReset:
          type: boolean
          const: false
        replay:
          type: string
          const: reexecution_not_identical_output
      required:
        - schemaVersion
        - source
        - resetCoverage
        - automaticTargetReset
        - replay
    PopulationDisclosure:
      type: object
      properties:
        schemaVersion:
          type: string
          const: 2026-10-16-population-disclosure.1
        purpose:
          anyOf:
            - type: object
              properties:
                state:
                  type: string
                  const: declared
                declaration:
                  $ref: '#/components/schemas/PopulationPurpose'
              required:
                - state
                - declaration
            - type: object
              properties:
                state:
                  type: string
                  const: not_recorded
                declaration:
                  type: 'null'
              required:
                - state
                - declaration
        materialization:
          anyOf:
            - type: object
              properties:
                state:
                  type: string
                  const: recorded
                provenance:
                  $ref: '#/components/schemas/PopulationProvenance'
              required:
                - state
                - provenance
            - type: object
              properties:
                state:
                  type: string
                  const: not_recorded
                provenance:
                  type: 'null'
              required:
                - state
                - provenance
        verification:
          type: string
          const: not_independently_verified
        notes:
          type: array
          items:
            type: string
      required:
        - schemaVersion
        - purpose
        - materialization
        - verification
        - notes
    PopulationCounts:
      type: object
      properties:
        planned:
          type: number
        retained:
          type: number
        started:
          type: number
        runnerStartObserved:
          type: number
        completed:
          type: number
        interrupted:
          type: number
        assessed:
          type: number
        notAssessable:
          type: number
        notApplicable:
          type: number
        evaluationAttempts:
          type: number
        execution:
          type: object
          properties:
            error:
              type: number
            queued:
              type: number
            running:
              type: number
            completed:
              type: number
            interrupted:
              type: number
            cancelled:
              type: number
          required:
            - error
            - queued
            - running
            - completed
            - interrupted
            - cancelled
        assessment:
          type: object
          properties:
            error:
              type: number
            completed:
              type: number
            not_requested:
              type: number
            pending:
              type: number
            partial:
              type: number
            unavailable:
              type: number
          required:
            - error
            - completed
            - not_requested
            - pending
            - partial
            - unavailable
      required:
        - planned
        - retained
        - started
        - runnerStartObserved
        - completed
        - interrupted
        - assessed
        - notAssessable
        - notApplicable
        - evaluationAttempts
        - execution
        - assessment
    PopulationSummary:
      type: object
      properties:
        scenarioId:
          type: string
        scenarioRevision:
          type: string
        inputDigest:
          type: string
        configurationId:
          type: string
        configurationDigest:
          type: string
        rubric:
          anyOf:
            - type: 'null'
            - $ref: '#/components/schemas/RubricRef'
        counts:
          $ref: '#/components/schemas/PopulationCounts'
        dimensions:
          type: array
          items:
            $ref: '#/components/schemas/DimensionSummary'
        exactChecks:
          type: array
          items:
            $ref: '#/components/schemas/ExactCheckSummary'
        taskMetrics:
          anyOf:
            - type: array
              items:
                $ref: '#/components/schemas/TaskMetricSummary'
        composites:
          anyOf:
            - type: array
              items:
                $ref: '#/components/schemas/CompositeSummary'
        measurements:
          type: array
          items:
            $ref: '#/components/schemas/MeasurementStats'
        sampleRuns:
          type: array
          items:
            $ref: '#/components/schemas/RunRef'
        sampleRunsTruncated:
          type: boolean
      required:
        - scenarioId
        - scenarioRevision
        - inputDigest
        - configurationId
        - configurationDigest
        - rubric
        - counts
        - dimensions
        - exactChecks
        - measurements
        - sampleRuns
        - sampleRunsTruncated
    ApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            repair:
              type: string
            requestId:
              type: string
            details:
              anyOf:
                - type: 'null'
                - type: string
                - type: number
                - type: boolean
                  const: false
                - type: boolean
                  const: true
                - type: array
                  items:
                    $ref: '#/components/schemas/JsonValue'
                - type: object
                  properties: {}
                  required: []
                  additionalProperties:
                    $ref: '#/components/schemas/JsonValue'
            validation:
              anyOf:
                - $ref: '#/components/schemas/ValidationDiagnostics'
          required:
            - code
            - message
            - repair
            - requestId
      required:
        - error
    PopulationPurpose:
      type: object
      properties:
        schemaVersion:
          type: string
          const: 2026-10-16-population-purpose.1
        kind:
          type: string
          enum:
            - exploration
            - fixed_suite
            - held_out
            - failure_selected
        rationale:
          anyOf:
            - type: string
      required:
        - schemaVersion
        - kind
    PopulationProvenance:
      type: object
      properties:
        schemaVersion:
          type: string
          const: 2026-10-15-population.1
        method:
          type: string
          enum:
            - matrix
            - sample
        seed:
          type: string
        candidateCount:
          type: number
        selectedIndices:
          type: array
          items:
            type: number
        sourceRecipeDigest:
          type: string
        axesDigest:
          type: string
      required:
        - schemaVersion
        - method
        - seed
        - candidateCount
        - selectedIndices
        - sourceRecipeDigest
        - axesDigest
    RubricRef:
      type: object
      properties:
        id:
          type: string
        version:
          type: string
        digest:
          type: string
      required:
        - id
        - version
        - digest
    DimensionSummary:
      type: object
      properties:
        dimensionId:
          type: string
        evaluator:
          anyOf:
            - type: 'null'
            - $ref: '#/components/schemas/EvaluatorRef'
        requested:
          type: number
        assessed:
          type: number
        notAssessable:
          type: number
        notApplicable:
          type: number
        missing:
          type: number
        invalid:
          type: number
        levels:
          $ref: '#/components/schemas/LevelStats'
        providerScores:
          anyOf:
            - $ref: '#/components/schemas/ProviderScoreStats'
        samples:
          type: array
          items:
            type: object
            properties:
              run:
                $ref: '#/components/schemas/RunRef'
              level:
                anyOf:
                  - type: 'null'
                  - type: number
              providerScore:
                anyOf:
                  - type: 'null'
                  - type: number
              state:
                type: string
              evidenceIds:
                type: array
                items:
                  type: string
            required:
              - run
              - level
              - state
              - evidenceIds
        samplesTruncated:
          type: boolean
      required:
        - dimensionId
        - evaluator
        - requested
        - assessed
        - notAssessable
        - notApplicable
        - missing
        - invalid
        - levels
        - samples
        - samplesTruncated
    ExactCheckSummary:
      type: object
      properties:
        checkId:
          type: string
        checkDigest:
          type: string
        required:
          type: boolean
        comparator:
          type: string
          enum:
            - equals
            - contains
            - exists
            - lte
            - gte
        numeric:
          anyOf:
            - $ref: '#/components/schemas/NumericCheck'
        plannedDenominator:
          type: number
        assessedDenominator:
          type: number
        satisfied:
          type: number
        violated:
          type: number
        unknown:
          type: number
        missing:
          type: number
        violationSamples:
          type: array
          items:
            $ref: '#/components/schemas/RunRef'
        violationSamplesTruncated:
          type: boolean
      required:
        - checkId
        - checkDigest
        - required
        - plannedDenominator
        - assessedDenominator
        - satisfied
        - violated
        - unknown
        - missing
        - violationSamples
        - violationSamplesTruncated
    TaskMetricSummary:
      type: object
      properties:
        schemaVersion:
          type: string
          const: 2026-10-16-task-metric.1
        definition:
          $ref: '#/components/schemas/TaskMetricDefinition'
        definitionDigest:
          type: string
        requested:
          type: number
        measured:
          type: number
        notAssessable:
          type: number
        missing:
          type: number
        invalid:
          type: number
        median:
          anyOf:
            - type: 'null'
            - type: number
        range:
          anyOf:
            - type: 'null'
            - type: object
              properties:
                minimum:
                  type: number
                maximum:
                  type: number
              required:
                - minimum
                - maximum
        samples:
          type: array
          items:
            type: object
            properties:
              run:
                $ref: '#/components/schemas/RunRef'
              value:
                anyOf:
                  - type: 'null'
                  - type: number
              state:
                type: string
                enum:
                  - not_assessable
                  - invalid
                  - measured
                  - missing
            required:
              - run
              - value
              - state
        samplesTruncated:
          type: boolean
      required:
        - schemaVersion
        - definition
        - definitionDigest
        - requested
        - measured
        - notAssessable
        - missing
        - invalid
        - median
        - range
        - samples
        - samplesTruncated
    CompositeSummary:
      type: object
      properties:
        schemaVersion:
          type: string
          const: 2026-10-16-composite.1
        policy:
          $ref: '#/components/schemas/CompositePolicy'
        policyDigest:
          type: string
        evaluator:
          anyOf:
            - type: 'null'
            - $ref: '#/components/schemas/EvaluatorRef'
        coverage:
          $ref: '#/components/schemas/CompositeCoverage'
        indices:
          $ref: '#/components/schemas/CompositeIndexStats'
        samples:
          type: array
          items:
            type: object
            properties:
              run:
                $ref: '#/components/schemas/RunRef'
              state:
                type: string
                enum:
                  - not_assessable
                  - computed
                  - constraint_violation
              value:
                anyOf:
                  - type: 'null'
                  - type: number
              reason:
                type: string
                enum:
                  - assessment_unavailable
                  - complete
                  - missing_dimension
                  - excluded_dimension
                  - invalid_dimension
                  - required_check_violated
                  - required_check_unknown
            required:
              - run
              - state
              - value
              - reason
        samplesTruncated:
          type: boolean
      required:
        - schemaVersion
        - policy
        - policyDigest
        - evaluator
        - coverage
        - indices
        - samples
        - samplesTruncated
    MeasurementStats:
      type: object
      properties:
        name:
          $ref: '#/components/schemas/RunMeasurementName'
        unit:
          type: string
          enum:
            - ms
            - tokens
            - USD
        provenance:
          type: string
          enum:
            - service_clock_claim_to_finish
            - runner_reported_metrics.durationMs
            - runner_reported_metrics.latencyMs
            - runner_reported_metrics.modelUsage.inputTokens
            - runner_reported_metrics.modelUsage.outputTokens
            - runner_reported_metrics.modelUsage.costUsd
        count:
          type: number
        missing:
          type: number
        invalid:
          type: number
        median:
          anyOf:
            - type: 'null'
            - type: number
        range:
          anyOf:
            - type: 'null'
            - type: object
              properties:
                minimum:
                  type: number
                maximum:
                  type: number
              required:
                - minimum
                - maximum
      required:
        - name
        - unit
        - provenance
        - count
        - missing
        - invalid
        - median
        - range
    RunRef:
      type: object
      properties:
        runId:
          type: string
        attemptId:
          anyOf:
            - type: 'null'
            - type: string
        repetition:
          type: number
        execution:
          $ref: '#/components/schemas/ExecutionState'
        assessment:
          $ref: '#/components/schemas/AssessmentState'
        assessmentId:
          anyOf:
            - type: 'null'
            - type: string
        reportPath:
          type: string
      required:
        - runId
        - attemptId
        - repetition
        - execution
        - assessment
        - assessmentId
        - reportPath
    JsonValue:
      description: >-
        Any JSON value: null, boolean, finite number, string, array or object.
        The request transport must contain valid JSON; canonical validation
        rejects nonfinite numbers.
    ValidationDiagnostics:
      type: object
      properties:
        issues:
          type: array
          items:
            $ref: '#/components/schemas/ValidationIssue'
        totalIssues:
          type: number
        omittedIssues:
          type: number
      required:
        - issues
        - totalIssues
        - omittedIssues
    EvaluatorRef:
      type: object
      properties:
        provider:
          type: string
        model:
          type: string
        version:
          type: string
        configurationDigest:
          anyOf:
            - type: string
      required:
        - provider
        - model
        - version
    LevelStats:
      type: object
      properties:
        count:
          type: number
        distribution:
          type: object
          properties:
            '0':
              type: number
            '1':
              type: number
            '2':
              type: number
            '3':
              type: number
            '4':
              type: number
          required:
            - '0'
            - '1'
            - '2'
            - '3'
            - '4'
        median:
          anyOf:
            - type: 'null'
            - type: object
              properties:
                lower:
                  type: number
                upper:
                  type: number
              required:
                - lower
                - upper
        range:
          anyOf:
            - type: 'null'
            - type: object
              properties:
                minimum:
                  type: number
                maximum:
                  type: number
              required:
                - minimum
                - maximum
      required:
        - count
        - distribution
        - median
        - range
    ProviderScoreStats:
      type: object
      properties:
        provider:
          type: string
          const: jev
        scale:
          type: array
          prefixItems:
            - type: number
              const: 0
            - type: number
              const: 4
          minItems: 2
          maxItems: 2
        ordinalConversion:
          type: string
          const: none
        count:
          type: number
        mean:
          anyOf:
            - type: 'null'
            - type: number
        median:
          anyOf:
            - type: 'null'
            - type: number
        range:
          anyOf:
            - type: 'null'
            - type: object
              properties:
                minimum:
                  type: number
                maximum:
                  type: number
              required:
                - minimum
                - maximum
      required:
        - provider
        - scale
        - ordinalConversion
        - count
        - mean
        - median
        - range
    NumericCheck:
      type: object
      properties:
        schemaVersion:
          type: string
          const: 2026-10-16-numeric-check.1
        unit:
          type: string
        absoluteTolerance:
          type: number
      required:
        - schemaVersion
        - unit
        - absoluteTolerance
    TaskMetricDefinition:
      type: object
      properties:
        schemaVersion:
          type: string
          const: 2026-10-16-task-metric.1
        id:
          type: string
        label:
          type: string
        path:
          type: string
        unit:
          type: string
        direction:
          type: string
          enum:
            - higher_is_better
            - lower_is_better
            - neutral
        source:
          anyOf:
            - type: object
              properties:
                kind:
                  type: string
                  const: service_state
                namespace:
                  type: string
                rowId:
                  type: string
                schemaVersion:
                  type: string
                  const: 2026-10-15-effect-check.1
                service:
                  type: string
              required:
                - kind
                - namespace
                - rowId
                - schemaVersion
                - service
            - type: object
              properties:
                kind:
                  type: string
                  const: service_activity
                schemaVersion:
                  type: string
                  const: 2026-10-15-effect-check.1
                service:
                  type: string
                where:
                  anyOf:
                    - type: object
                      properties:
                        path:
                          type: string
                        equals:
                          $ref: '#/components/schemas/JsonValue'
                      required:
                        - path
                        - equals
              required:
                - kind
                - schemaVersion
                - service
            - type: object
              properties:
                kind:
                  type: string
                  const: service_pending
                schemaVersion:
                  type: string
                  const: 2026-10-15-effect-check.1
                service:
                  type: string
              required:
                - kind
                - schemaVersion
                - service
      required:
        - schemaVersion
        - id
        - label
        - path
        - unit
    CompositePolicy:
      type: object
      properties:
        schemaVersion:
          type: string
          const: 2026-10-16-composite.1
        method:
          type: string
          const: weighted_mean_ordinal
        weights:
          type: array
          items:
            type: object
            properties:
              dimensionId:
                type: string
              weight:
                type: number
            required:
              - dimensionId
              - weight
      required:
        - schemaVersion
        - method
        - weights
    CompositeCoverage:
      type: object
      properties:
        requested:
          type: number
        computed:
          type: number
        notAssessable:
          type: number
        constraintViolation:
          type: number
        missingDimensionRuns:
          type: number
        notApplicableDimensionRuns:
          type: number
        invalidDimensionRuns:
          type: number
        requiredChecksUnknownRuns:
          type: number
        reasons:
          type: object
          properties:
            assessment_unavailable:
              type: number
            complete:
              type: number
            missing_dimension:
              type: number
            excluded_dimension:
              type: number
            invalid_dimension:
              type: number
            required_check_violated:
              type: number
            required_check_unknown:
              type: number
          required:
            - assessment_unavailable
            - complete
            - missing_dimension
            - excluded_dimension
            - invalid_dimension
            - required_check_violated
            - required_check_unknown
      required:
        - requested
        - computed
        - notAssessable
        - constraintViolation
        - missingDimensionRuns
        - notApplicableDimensionRuns
        - invalidDimensionRuns
        - requiredChecksUnknownRuns
        - reasons
    CompositeIndexStats:
      type: object
      properties:
        count:
          type: number
        mean:
          anyOf:
            - type: 'null'
            - type: number
        median:
          anyOf:
            - type: 'null'
            - type: number
        range:
          anyOf:
            - type: 'null'
            - type: object
              properties:
                minimum:
                  type: number
                maximum:
                  type: number
              required:
                - minimum
                - maximum
      required:
        - count
        - mean
        - median
        - range
    RunMeasurementName:
      type: string
      enum:
        - serviceClaimToFinishMs
        - runnerDurationMs
        - runnerLatencyMs
        - targetInputTokens
        - targetOutputTokens
        - targetCostUsd
    ExecutionState:
      type: string
      enum:
        - error
        - queued
        - running
        - completed
        - interrupted
        - cancelled
    AssessmentState:
      type: string
      enum:
        - error
        - completed
        - not_requested
        - pending
        - partial
        - unavailable
    ValidationIssue:
      type: object
      properties:
        path:
          type: array
          items:
            anyOf:
              - type: string
              - type: number
        code:
          type: string
        message:
          type: string
        pathTruncated:
          anyOf:
            - type: boolean
              const: true
      required:
        - path
        - code
        - message
  responses:
    BadRequest:
      description: >-
        Malformed request or missing operation key. Repair the input before
        retrying.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Unauthorized:
      description: >-
        Missing, expired or revoked authority. Complete supported sign-in or use
        an authorized credential.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Forbidden:
      description: >-
        The current capability, actor, audience or ownership grant does not
        allow this operation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    NotFound:
      description: The exact resource is unavailable under the current authority and scope.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Conflict:
      description: >-
        Selected context, epoch, revision, lease or saved operation intent
        conflicts; inspect retained state.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Gone:
      description: >-
        Retained content is expired, deleted or unavailable under its retention
        fence. Metadata is not a replacement payload.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    PayloadTooLarge:
      description: >-
        Request, response or retained-resource size exceeds this operation’s
        enforced bound.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    UnsupportedMediaType:
      description: Send the documented JSON or exact artifact media type.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    InvalidInput:
      description: >-
        Input failed canonical validation. Inspect error.validation and repair
        the indicated fields.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Capacity:
      description: >-
        Bounded capacity or resource admission rejected the operation. Inspect
        retained work before retrying.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Internal:
      description: >-
        The service could not complete the request. Inspect retained state
        before exact-key recovery.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Unavailable:
      description: >-
        A required service, provider or authority check is unavailable. Existing
        evidence remains separate from this failure.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
  securitySchemes:
    FiredrillCredential:
      type: http
      scheme: bearer
      description: >-
        Opaque Firedrill interactive or scoped machine credential. The CLI
        handles human-approved login; CI stores its scoped credential as
        FIREDRILL_TOKEN. Capabilities and project/environment ownership are
        rechecked at use.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.