> ## 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. # Preview a simulation recipe > Requires `read`. Validates scope, recipe and selected Tool bindings without allocating runs or probing the target. Admission is an observation, not a capacity reservation or execution proof. Replace the example scope and command with your authorized project/environment and application. ## OpenAPI ````yaml /api-reference/openapi.json post /v1/recipes/preview 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/recipes/preview: post: tags: - simulations summary: Preview a simulation recipe description: >- Requires `read`. Validates scope, recipe and selected Tool bindings without allocating runs or probing the target. Admission is an observation, not a capacity reservation or execution proof. Replace the example scope and command with your authorized project/environment and application. operationId: recipes_preview parameters: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/RecipePreviewInput' examples: observation_only: summary: Preview an explicitly selected Tool-free command recipe value: schemaVersion: 2026-10-14-preparation.1 projectId: prj_000000000000000000000001 environmentId: env_000000000000000000000001 recipe: schemaVersion: '2026-10-14' name: response-observations target: kind: command argv: - python - agent.py scenarios: - id: answer name: Answer a request input: prompt: Summarize the supplied document. responses: '200': description: The retained resource or operation response. content: application/json: schema: $ref: '#/components/schemas/RecipePreview' '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: RecipePreviewInput: type: object properties: projectId: type: string minLength: 1 maxLength: 160 environmentId: type: string minLength: 1 maxLength: 160 schemaVersion: type: string const: 2026-10-14-preparation.1 recipe: $ref: '#/components/schemas/RecipeInput' required: - projectId - environmentId - schemaVersion - recipe additionalProperties: false RecipePreview: type: object properties: schemaVersion: type: string const: 2026-10-14-preparation.1 projectId: type: string environmentId: type: string checkedAt: type: string recipeDigest: type: string retention: anyOf: - $ref: '#/components/schemas/RetentionPolicyDisclosure' populationDisclosure: anyOf: - $ref: '#/components/schemas/PopulationDisclosure' scenarios: type: array items: type: object properties: id: type: string revision: type: string required: - id - revision expansion: type: object properties: scenarios: type: number configurations: type: number repetitions: type: number runs: type: number maximumTargetInvocations: type: number required: - scenarios - configurations - repetitions - runs - maximumTargetInvocations target: type: object properties: kind: type: string enum: - command - http - native - isolated_node executionOwner: type: string const: customer isolation: type: string enum: - customer_process - remote_application - customer_isolated_runner readiness: type: string const: not_checked probePerformed: type: boolean const: false disclosure: $ref: '#/components/schemas/TargetDisclosure' required: - kind - executionOwner - isolation - readiness - probePerformed - disclosure targetExecution: anyOf: - $ref: '#/components/schemas/TargetExecutionDisclosure' services: type: object properties: bindings: type: array items: $ref: '#/components/schemas/ServiceBinding' datasetOverrides: type: array items: type: object properties: scenarioId: type: string datasets: type: object properties: {} required: [] additionalProperties: type: string required: - scenarioId - datasets required: - bindings - datasetOverrides limits: type: object properties: maxActiveRuns: type: number pendingRunsPerOrganization: anyOf: - type: 'null' - type: number pendingRunsGlobal: type: number recipeBytes: type: number expandedBatchBytes: type: number invocationTimeoutMs: type: number maxOutputBytes: type: number maxRuns: anyOf: - type: 'null' - type: number required: - maxActiveRuns - pendingRunsPerOrganization - pendingRunsGlobal - recipeBytes - expandedBatchBytes - invocationTimeoutMs - maxOutputBytes - maxRuns estimates: type: object properties: expandedInputBytes: type: number maximumConcurrentRuns: type: number totalServiceInstances: type: number maximumConcurrentServiceInstances: type: number required: - expandedInputBytes - maximumConcurrentRuns - totalServiceInstances - maximumConcurrentServiceInstances admission: type: object properties: state: type: string enum: - blocked - currently_admissible reserved: type: boolean const: false canSubmit: type: boolean organizationPendingRuns: anyOf: - type: 'null' - type: number scopePendingRuns: type: number platformCapacityAvailable: type: boolean blockers: type: array items: type: object properties: code: type: string message: type: string repair: type: string required: - code - message - repair required: - state - reserved - canSubmit - organizationPendingRuns - scopePendingRuns - platformCapacityAvailable - blockers assessment: type: object properties: requestedRuns: type: number evaluatorConfigured: type: boolean capacityReserved: type: boolean const: false policy: anyOf: - type: 'null' - $ref: '#/components/schemas/EvaluatorAdmissionPolicy' required: - requestedRuns - evaluatorConfigured - capacityReserved charge: type: object properties: amount: type: number const: 0 policy: type: string const: free_early_access customerInferenceAndRuntimeCost: type: string const: unknown_separate required: - amount - policy - customerInferenceAndRuntimeCost limitations: type: array items: type: string required: - schemaVersion - projectId - environmentId - checkedAt - recipeDigest - scenarios - expansion - target - services - limits - estimates - admission - assessment - charge - limitations RecipeInput: type: object properties: schemaVersion: type: string const: '2026-10-14' name: type: string minLength: 1 maxLength: 200 scenarios: minItems: 1 type: array items: $ref: '#/components/schemas/ScenarioInput' target: $ref: '#/components/schemas/TargetInput' targetExecution: type: object properties: schemaVersion: type: string const: 2026-10-16-target-execution.1 nonHermeticParallel: type: string const: acknowledged required: - schemaVersion - nonHermeticParallel additionalProperties: false population: type: object properties: schemaVersion: type: string const: 2026-10-15-population.1 method: type: string enum: - matrix - sample seed: type: string minLength: 1 maxLength: 200 candidateCount: type: integer minimum: 1 maximum: 1000000000 selectedIndices: minItems: 1 type: array items: type: integer minimum: 0 maximum: 999999999 sourceRecipeDigest: type: string pattern: ^[a-f0-9]{64}$ axesDigest: type: string pattern: ^[a-f0-9]{64}$ required: - schemaVersion - method - seed - candidateCount - selectedIndices - sourceRecipeDigest - axesDigest additionalProperties: false populationPurpose: $ref: '#/components/schemas/PopulationPurposeInput' services: default: [] type: array items: $ref: '#/components/schemas/ServiceBindingInput' configurations: default: - id: default parameters: {} minItems: 1 type: array items: type: object properties: id: type: string minLength: 1 maxLength: 160 parameters: default: {} type: object propertyNames: type: string additionalProperties: $ref: '#/components/schemas/JsonValue' required: - id additionalProperties: false repetitions: default: 1 type: integer minimum: 1 maximum: 9007199254740991 concurrency: default: 1 type: integer minimum: 1 maximum: 9007199254740991 limits: default: timeoutMs: 60000 maxRuns: null maxOutputBytes: 1048576 type: object properties: timeoutMs: default: 60000 type: integer minimum: 100 maximum: 2592000000 maxRuns: default: null anyOf: - type: integer minimum: 1 maximum: 9007199254740991 - type: 'null' maxOutputBytes: default: 1048576 type: integer minimum: 1024 maximum: 8388608 gate: type: object properties: requireCompleted: default: true type: boolean requireExactChecks: default: true type: boolean minimumLevels: default: {} type: object propertyNames: type: string additionalProperties: type: integer minimum: 0 maximum: 4 additionalProperties: false required: - schemaVersion - name - scenarios - target additionalProperties: false RetentionPolicyDisclosure: type: object properties: schemaVersion: type: string const: 2026-10-15-retention.1 activatedAt: anyOf: - type: 'null' - type: string newResourcePolicyActive: type: boolean runPayloadDays: type: number const: 30 reusableStateDaysAfterCompute: type: number const: 7 metadataDays: type: number const: 365 operationalLogDays: type: number const: 14 checkedAt: type: string estimatedRunPayloadExpiresAt: anyOf: - type: 'null' - type: string estimateBinding: type: boolean const: false existingRecords: type: string const: historical_preserved savedDefinitions: type: string const: until_explicit_authorized_deletion backupDisposition: type: string const: separate_retention_no_instant_erasure operationalLogRetention: type: string const: deployment_verification_separate authLifetimes: type: string const: unchanged required: - schemaVersion - activatedAt - newResourcePolicyActive - runPayloadDays - reusableStateDaysAfterCompute - metadataDays - operationalLogDays - checkedAt - estimatedRunPayloadExpiresAt - estimateBinding - existingRecords - savedDefinitions - backupDisposition - operationalLogRetention - authLifetimes 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 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 TargetExecutionDisclosure: type: object properties: schemaVersion: type: string const: 2026-10-16-target-execution.1 requestedConcurrency: type: number acknowledgement: type: string enum: - not_recorded - caller_declared mode: type: string enum: - isolated_runner_contract - sequential_non_hermetic - acknowledged_shared_state - unacknowledged_parallel automaticTargetReset: type: boolean const: false isolationAttestation: type: string const: not_provided required: - schemaVersion - requestedConcurrency - acknowledgement - mode - automaticTargetReset - isolationAttestation ServiceBinding: type: object properties: alias: type: string buildId: type: string seed: type: string operations: type: array items: type: string datasetId: anyOf: - type: string control: anyOf: - type: object properties: schemaVersion: type: string const: 2026-10-15-service-control.1 operations: type: array items: type: string required: - schemaVersion - operations - type: object properties: schemaVersion: type: string const: 2026-10-15-service-control.2 operations: type: array items: type: string clock: anyOf: - type: object properties: advance: type: boolean const: true required: - advance required: - schemaVersion - operations required: - alias - buildId - seed - operations EvaluatorAdmissionPolicy: type: object properties: maxRequestsPerBatch: anyOf: - type: 'null' - type: number maxConcurrentRequests: type: number maxInputBytes: type: number maxOutputTokens: anyOf: - type: 'null' - type: number maxAttemptsPerAssessment: type: number required: - maxRequestsPerBatch - maxConcurrentRequests - maxInputBytes - maxOutputTokens - maxAttemptsPerAssessment 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 ScenarioInput: type: object properties: id: type: string minLength: 1 maxLength: 160 name: type: string minLength: 1 maxLength: 200 input: $ref: '#/components/schemas/JsonValue' description: type: string maxLength: 4000 checks: default: [] maxItems: 100 type: array items: $ref: '#/components/schemas/ExactCheckInput' rubric: $ref: '#/components/schemas/RubricInput' metrics: minItems: 1 maxItems: 32 type: array items: $ref: '#/components/schemas/TaskMetricDefinitionInput' serviceDatasets: type: object propertyNames: type: string pattern: ^[a-z][a-z0-9_-]{0,63}$ additionalProperties: type: string minLength: 1 maxLength: 160 sequence: $ref: '#/components/schemas/SequenceInput' required: - id - name - input additionalProperties: false TargetInput: oneOf: - type: object properties: metadata: type: object properties: schemaVersion: type: string const: 2026-10-15-target-metadata.1 source: type: object properties: revision: type: string minLength: 1 maxLength: 200 contentDigest: type: string pattern: ^sha256:[a-f0-9]{64}$ dirty: default: unknown type: string enum: - clean - dirty - unknown required: - revision additionalProperties: false resetCoverage: type: object properties: applicationDatabase: type: string enum: - customer_managed - not_reset - not_used - unknown cache: type: string enum: - customer_managed - not_reset - not_used - unknown filesystem: type: string enum: - customer_managed - not_reset - not_used - unknown conversationMemory: type: string enum: - customer_managed - not_reset - not_used - unknown outstandingJobs: type: string enum: - customer_managed - not_reset - not_used - unknown browserProfile: type: string enum: - customer_managed - not_reset - not_used - unknown externalState: type: string enum: - customer_managed - not_reset - not_used - unknown additionalProperties: false required: - schemaVersion additionalProperties: false kind: type: string const: command argv: minItems: 1 maxItems: 128 type: array items: type: string maxLength: 8192 cwd: type: string maxLength: 4096 required: - kind - argv additionalProperties: false - type: object properties: metadata: type: object properties: schemaVersion: type: string const: 2026-10-15-target-metadata.1 source: type: object properties: revision: type: string minLength: 1 maxLength: 200 contentDigest: type: string pattern: ^sha256:[a-f0-9]{64}$ dirty: default: unknown type: string enum: - clean - dirty - unknown required: - revision additionalProperties: false resetCoverage: type: object properties: applicationDatabase: type: string enum: - customer_managed - not_reset - not_used - unknown cache: type: string enum: - customer_managed - not_reset - not_used - unknown filesystem: type: string enum: - customer_managed - not_reset - not_used - unknown conversationMemory: type: string enum: - customer_managed - not_reset - not_used - unknown outstandingJobs: type: string enum: - customer_managed - not_reset - not_used - unknown browserProfile: type: string enum: - customer_managed - not_reset - not_used - unknown externalState: type: string enum: - customer_managed - not_reset - not_used - unknown additionalProperties: false required: - schemaVersion additionalProperties: false kind: type: string const: http url: type: string format: uri method: default: POST type: string enum: - POST - PUT required: - kind - url additionalProperties: false - type: object properties: metadata: type: object properties: schemaVersion: type: string const: 2026-10-15-target-metadata.1 source: type: object properties: revision: type: string minLength: 1 maxLength: 200 contentDigest: type: string pattern: ^sha256:[a-f0-9]{64}$ dirty: default: unknown type: string enum: - clean - dirty - unknown required: - revision additionalProperties: false resetCoverage: type: object properties: applicationDatabase: type: string enum: - customer_managed - not_reset - not_used - unknown cache: type: string enum: - customer_managed - not_reset - not_used - unknown filesystem: type: string enum: - customer_managed - not_reset - not_used - unknown conversationMemory: type: string enum: - customer_managed - not_reset - not_used - unknown outstandingJobs: type: string enum: - customer_managed - not_reset - not_used - unknown browserProfile: type: string enum: - customer_managed - not_reset - not_used - unknown externalState: type: string enum: - customer_managed - not_reset - not_used - unknown additionalProperties: false required: - schemaVersion additionalProperties: false kind: type: string const: native name: type: string minLength: 1 maxLength: 200 required: - kind - name additionalProperties: false - type: object properties: metadata: type: object properties: schemaVersion: type: string const: 2026-10-15-target-metadata.1 source: type: object properties: revision: type: string minLength: 1 maxLength: 200 contentDigest: type: string pattern: ^sha256:[a-f0-9]{64}$ dirty: default: unknown type: string enum: - clean - dirty - unknown required: - revision additionalProperties: false resetCoverage: type: object properties: applicationDatabase: type: string enum: - customer_managed - not_reset - not_used - unknown cache: type: string enum: - customer_managed - not_reset - not_used - unknown filesystem: type: string enum: - customer_managed - not_reset - not_used - unknown conversationMemory: type: string enum: - customer_managed - not_reset - not_used - unknown outstandingJobs: type: string enum: - customer_managed - not_reset - not_used - unknown browserProfile: type: string enum: - customer_managed - not_reset - not_used - unknown externalState: type: string enum: - customer_managed - not_reset - not_used - unknown additionalProperties: false required: - schemaVersion additionalProperties: false kind: type: string const: isolated_node entrypoint: type: string pattern: ^[A-Za-z0-9_-][A-Za-z0-9._/-]{0,159}$ image: type: string pattern: ^sha256:[a-f0-9]{64}$ files: minItems: 1 maxItems: 64 type: array items: type: object properties: path: type: string pattern: ^[A-Za-z0-9_-][A-Za-z0-9._/-]{0,159}$ bytes: type: integer minimum: 1 maximum: 2097152 sha256: type: string pattern: ^[a-f0-9]{64}$ required: - path - bytes - sha256 additionalProperties: false approvedServices: default: [] maxItems: 8 type: array items: type: object properties: id: type: string pattern: ^[a-z][a-z0-9-]{0,47}$ url: type: string format: uri routes: minItems: 1 maxItems: 16 type: array items: type: object properties: method: type: string enum: - GET - POST - PUT - PATCH - DELETE path: type: string maxLength: 256 pattern: ^\/[A-Za-z0-9/_-]*$ required: - method - path additionalProperties: false allowPrivateAddress: type: boolean const: true required: - id - url - routes additionalProperties: false required: - kind - entrypoint - image - files additionalProperties: false PopulationPurposeInput: 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: type: string minLength: 1 maxLength: 2000 required: - schemaVersion - kind additionalProperties: false ServiceBindingInput: type: object properties: alias: type: string pattern: ^[a-z][a-z0-9_-]{0,63}$ buildId: type: string minLength: 1 maxLength: 160 datasetId: type: string minLength: 1 maxLength: 160 seed: type: string maxLength: 80 pattern: ^(0|[1-9][0-9]*)$ operations: minItems: 1 maxItems: 256 type: array items: type: string minLength: 1 maxLength: 160 control: oneOf: - type: object properties: schemaVersion: type: string const: 2026-10-15-service-control.1 operations: minItems: 1 maxItems: 256 type: array items: type: string minLength: 1 maxLength: 160 required: - schemaVersion - operations additionalProperties: false - type: object properties: schemaVersion: type: string const: 2026-10-15-service-control.2 operations: maxItems: 256 type: array items: type: string minLength: 1 maxLength: 160 clock: type: object properties: advance: type: boolean const: true required: - advance additionalProperties: false required: - schemaVersion - operations additionalProperties: false required: - alias - buildId - seed - operations additionalProperties: false 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. 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 ValidationDiagnostics: type: object properties: issues: type: array items: $ref: '#/components/schemas/ValidationIssue' totalIssues: type: number omittedIssues: type: number required: - issues - totalIssues - omittedIssues ExactCheckInput: type: object properties: id: type: string minLength: 1 maxLength: 160 description: type: string minLength: 1 maxLength: 2000 path: type: string maxLength: 1000 comparator: type: string enum: - equals - contains - exists - lte - gte expected: $ref: '#/components/schemas/JsonValue' required: default: true type: boolean source: oneOf: - type: object properties: schemaVersion: type: string const: 2026-10-15-effect-check.1 service: type: string pattern: ^[a-z][a-z0-9_-]{0,63}$ kind: type: string const: service_state namespace: type: string minLength: 1 maxLength: 160 rowId: type: string minLength: 1 maxLength: 512 required: - schemaVersion - service - kind - namespace - rowId additionalProperties: false - type: object properties: schemaVersion: type: string const: 2026-10-15-effect-check.1 service: type: string pattern: ^[a-z][a-z0-9_-]{0,63}$ kind: type: string const: service_activity where: type: object properties: path: type: string maxLength: 1000 equals: $ref: '#/components/schemas/JsonValue' required: - path - equals additionalProperties: false required: - schemaVersion - service - kind additionalProperties: false - type: object properties: schemaVersion: type: string const: 2026-10-15-effect-check.1 service: type: string pattern: ^[a-z][a-z0-9_-]{0,63}$ kind: type: string const: service_pending required: - schemaVersion - service - kind additionalProperties: false numeric: type: object properties: schemaVersion: type: string const: 2026-10-16-numeric-check.1 unit: type: string minLength: 1 maxLength: 64 absoluteTolerance: default: 0 type: number minimum: 0 required: - schemaVersion - unit additionalProperties: false required: - id - description - path - comparator additionalProperties: false RubricInput: type: object properties: composite: $ref: '#/components/schemas/CompositePolicyInput' id: type: string minLength: 1 maxLength: 160 version: type: string minLength: 1 maxLength: 160 policyVersion: type: string const: 2026-10-15-assessment.1 dimensions: minItems: 1 maxItems: 12 type: array items: type: object properties: id: type: string minLength: 1 maxLength: 160 description: type: string minLength: 1 maxLength: 4000 anchors: type: array prefixItems: - type: string minLength: 1 maxLength: 4000 - type: string minLength: 1 maxLength: 4000 - type: string minLength: 1 maxLength: 4000 - type: string minLength: 1 maxLength: 4000 - type: string minLength: 1 maxLength: 4000 evidenceKinds: minItems: 1 maxItems: 4 type: array items: type: string enum: - text - image - audio - video applicability: oneOf: - type: object properties: state: type: string const: applicable required: - state additionalProperties: false - type: object properties: state: type: string const: not_applicable reason: type: string minLength: 1 maxLength: 2000 required: - state - reason additionalProperties: false missingEvidence: type: string const: not_assessable required: - id - description - anchors additionalProperties: false required: - id - version - dimensions additionalProperties: false description: >- Five ordered task-specific anchors represent levels 0–4. Structural JSON Schema cannot enforce unique IDs, applicability policy, comparator rules or all cross-field constraints; use recipe preview. TaskMetricDefinitionInput: type: object properties: schemaVersion: type: string const: 2026-10-16-task-metric.1 id: type: string minLength: 1 maxLength: 160 label: type: string minLength: 1 maxLength: 200 path: type: string maxLength: 1000 unit: type: string minLength: 1 maxLength: 64 direction: type: string enum: - higher_is_better - lower_is_better - neutral source: oneOf: - type: object properties: schemaVersion: type: string const: 2026-10-15-effect-check.1 service: type: string pattern: ^[a-z][a-z0-9_-]{0,63}$ kind: type: string const: service_state namespace: type: string minLength: 1 maxLength: 160 rowId: type: string minLength: 1 maxLength: 512 required: - schemaVersion - service - kind - namespace - rowId additionalProperties: false - type: object properties: schemaVersion: type: string const: 2026-10-15-effect-check.1 service: type: string pattern: ^[a-z][a-z0-9_-]{0,63}$ kind: type: string const: service_activity where: type: object properties: path: type: string maxLength: 1000 equals: $ref: '#/components/schemas/JsonValue' required: - path - equals additionalProperties: false required: - schemaVersion - service - kind additionalProperties: false - type: object properties: schemaVersion: type: string const: 2026-10-15-effect-check.1 service: type: string pattern: ^[a-z][a-z0-9_-]{0,63}$ kind: type: string const: service_pending required: - schemaVersion - service - kind additionalProperties: false required: - schemaVersion - id - label - path - unit additionalProperties: false SequenceInput: type: object properties: schemaVersion: type: string const: 2026-10-14-sequence.1 steps: minItems: 1 maxItems: 10000 type: array items: oneOf: - type: object properties: id: type: string minLength: 1 maxLength: 160 when: type: object properties: path: type: string maxLength: 1000 comparator: type: string enum: - equals - contains - exists - lte - gte expected: $ref: '#/components/schemas/JsonValue' step: type: string minLength: 1 maxLength: 160 required: - path - comparator - step additionalProperties: false kind: type: string const: target input: $ref: '#/components/schemas/JsonValue' required: - id - kind additionalProperties: false - type: object properties: id: type: string minLength: 1 maxLength: 160 when: type: object properties: path: type: string maxLength: 1000 comparator: type: string enum: - equals - contains - exists - lte - gte expected: $ref: '#/components/schemas/JsonValue' step: type: string minLength: 1 maxLength: 160 required: - path - comparator - step additionalProperties: false kind: type: string const: service service: type: string pattern: ^[a-z][a-z0-9_-]{0,63}$ operationId: type: string minLength: 1 maxLength: 160 arguments: type: object propertyNames: type: string additionalProperties: $ref: '#/components/schemas/JsonValue' required: - id - kind - service - operationId - arguments additionalProperties: false - type: object properties: id: type: string minLength: 1 maxLength: 160 when: type: object properties: path: type: string maxLength: 1000 comparator: type: string enum: - equals - contains - exists - lte - gte expected: $ref: '#/components/schemas/JsonValue' step: type: string minLength: 1 maxLength: 160 required: - path - comparator - step additionalProperties: false kind: type: string const: wait_for service: type: string pattern: ^[a-z][a-z0-9_-]{0,63}$ operationId: type: string minLength: 1 maxLength: 160 arguments: type: object propertyNames: type: string additionalProperties: $ref: '#/components/schemas/JsonValue' until: type: object properties: path: type: string maxLength: 1000 comparator: type: string enum: - equals - contains - exists - lte - gte expected: $ref: '#/components/schemas/JsonValue' required: - path - comparator additionalProperties: false maxAttempts: type: integer minimum: 1 maximum: 100000 intervalMs: type: integer minimum: 100 maximum: 60000 required: - id - kind - service - operationId - arguments - until - maxAttempts - intervalMs additionalProperties: false - type: object properties: id: type: string minLength: 1 maxLength: 160 when: type: object properties: path: type: string maxLength: 1000 comparator: type: string enum: - equals - contains - exists - lte - gte expected: $ref: '#/components/schemas/JsonValue' step: type: string minLength: 1 maxLength: 160 required: - path - comparator - step additionalProperties: false kind: type: string const: advance_time service: type: string pattern: ^[a-z][a-z0-9_-]{0,63}$ toUs: type: integer minimum: 0 maximum: 9007199254740991 maxEvents: default: 100 type: integer minimum: 1 maximum: 1000 required: - id - kind - service - toUs additionalProperties: false - type: object properties: id: type: string minLength: 1 maxLength: 160 when: type: object properties: path: type: string maxLength: 1000 comparator: type: string enum: - equals - contains - exists - lte - gte expected: $ref: '#/components/schemas/JsonValue' step: type: string minLength: 1 maxLength: 160 required: - path - comparator - step additionalProperties: false kind: type: string const: snapshot service: type: string pattern: ^[a-z][a-z0-9_-]{0,63}$ required: - id - kind - service additionalProperties: false - type: object properties: id: type: string minLength: 1 maxLength: 160 when: type: object properties: path: type: string maxLength: 1000 comparator: type: string enum: - equals - contains - exists - lte - gte expected: $ref: '#/components/schemas/JsonValue' step: type: string minLength: 1 maxLength: 160 required: - path - comparator - step additionalProperties: false kind: type: string const: restore service: type: string pattern: ^[a-z][a-z0-9_-]{0,63}$ snapshotStepId: type: string minLength: 1 maxLength: 160 boundary: type: string const: service_only required: - id - kind - service - snapshotStepId - boundary additionalProperties: false required: - schemaVersion - steps additionalProperties: false 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 CompositePolicyInput: type: object properties: schemaVersion: type: string const: 2026-10-16-composite.1 method: type: string const: weighted_mean_ordinal weights: minItems: 1 maxItems: 12 type: array items: type: object properties: dimensionId: type: string minLength: 1 maxLength: 160 weight: type: integer minimum: 1 maximum: 1000 required: - dimensionId - weight additionalProperties: false required: - schemaVersion - method - weights additionalProperties: false 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.