Definite API

Definite API as documented publicly: 59 operations. Contract generated from the documentation by API Evangelist (2026-10-29); not the provider's own document.

Operations 59

GET /.well-known/jwks.json Signing keys #
GET /decision-streams List configured destinations with delivery stats. #
POST /decision-streams Create a destination. Credentials are write-only and never returned. #
POST /decision-streams/deliveries/{deliveryid}/retry Retry a failed delivery. #
DELETE /decision-streams/{destinationid} Delete a destination and its queued deliveries. #
PUT /decision-streams/{destinationid} Update configuration or enabled state. #
POST /decision-streams/{destinationid}/test Publish a synthetic test event. #
GET /ledger History #
GET /ledger/checkpoints History #
GET /ledger/encrypted Advanced #
GET /ledger/proof/bundle Verification #
GET /ledger/proof/consistency Verification #
GET /ledger/proof/inclusion Verification #
GET /ledger/verification-summary Verification #
GET /ledger/verify Verification #
GET /siem-exports List configured destinations with delivery stats, last success, and last error. #
POST /siem-exports Create a destination. Secrets are write‑only and stored in the tenant secret store. #
DELETE /siem-exports/{destinationid} Delete a destination. #
PUT /siem-exports/{destinationid} Update configuration or enabled state. #
POST /siem-exports/{destinationid}/replay Re‑deliver records over a selected time window. #
POST /siem-exports/{destinationid}/test Send a synthetic test record. #
GET /v1/artifacts GET /v1/artifacts , GET /v1/artifacts/{artifact_id} , GET /v1/artifacts/{artifact_id}/lineage #
GET /v1/artifacts/{artifactId} GET /v1/artifacts , GET /v1/artifacts/{artifact_id} , GET /v1/artifacts/{artifact_id}/lineage #
GET /v1/artifacts/{artifactId}/lineage GET /v1.artifacts , GET /v1/artifacts/{artifact_id} , GET /v1/artifacts/{artifact_id}/lineage #
GET /v1/data-sources GET /v1/data-sources — connected sources with freshness ( current , late , missing , error , not_configured ). #
GET /v1/exceptions Exception states: open , investigating , awaiting_human , resolved . Reviewer identity comes from the authenticated session at the console boundary; client-supplied reviewer identi #
GET /v1/exceptions/{exceptionId} Exception states: open , investigating , awaiting_human , resolved . Reviewer identity comes from the authenticated session at the console boundary; client-supplied reviewer identi #
PATCH /v1/exceptions/{exceptionId} Exception states: open , investigating , awaiting_human , resolved . Reviewer identity comes from the authenticated session at the console boundary; client-supplied reviewer identi #
POST /v1/exceptions/{exceptionId}/reviews Exception states: open , investigating , awaiting_human , resolved . Reviewer identity comes from the authenticated session at the console boundary; client-supplied reviewer identi #
GET /v1/form-definitions Definitions #
GET /v1/form-definitions/{definitionId} Definitions #
GET /v1/mapping-proposals/{proposalId} Agent-proposed mappings are versioned and reviewed; proposal states are pending , approved , rejected , and changes_requested . #
POST /v1/mapping-proposals/{proposalId}/activate Agent-proposed mappings are versioned and reviewed; proposal states are pending , approved , rejected , and changes_requested . #
POST /v1/mapping-proposals/{proposalId}/reviews Agent-proposed mappings are versioned and reviewed; proposal states are pending , approved , rejected , and changes_requested . #
GET /v1/programs Programs and runs #
POST /v1/programs Programs and runs #
GET /v1/programs/{programId} Programs and runs #
GET /v1/programs/{programId}/mapping-proposals Agent-proposed mappings are versioned and reviewed; proposal states are pending , approved , rejected , and changes_requested . #
POST /v1/programs/{programId}/run-groups Programs and runs #
POST /v1/programs/{programId}/runs Programs and runs #
GET /v1/readiness verdict counts, active runs, open exceptions, missing inputs, ledger integrity, program status. Metadata, never a verdict. #
GET /v1/receipts signed rule receipts. #
GET /v1/receipts/{receiptId} signed rule receipts. #
GET /v1/reporting-entities Readiness and portfolio #
GET /v1/reporting-entities/{entityId}/form-obligations Readiness and portfolio #
GET /v1/reporting-portfolio Readiness and portfolio #
GET /v1/runs Programs and runs #
GET /v1/runs/{runId} GET /v1/runs/{runId} #
GET /v1/runs/{runId}/adjustments GET /v1/runs/{runId}/adjustments #
POST /v1/runs/{runId}/adjustments POST /v1/runs/{runId}/adjustments #
GET /v1/runs/{runId}/agent-evidence-selections GET /v1/runs/{runId}/agent-evidence-selections #
GET /v1/runs/{runId}/cells GET /v1/runs/{runId}/cells #
GET /v1/runs/{runId}/cells/{conceptId} GET /v1/runs/{runId}/cells/{conceptId} #
GET /v1/runs/{runId}/events Immutable stage telemetry. #
GET /v1/runs/{runId}/exports Read‑only over API keys; authorizing a final export is a console action by an admin or owner. #
GET /v1/runs/{runId}/final-evidence GET /v1/runs/{runId}/final-evidence #
GET /v1/runs/{runId}/inputs GET /v1/runs/{runId}/inputs #
GET /v1/runs/{runId}/reconciliations GET /v1/runs/{runId}/reconciliations #
POST /v1/runs/{runId}/retry POST /v1/runs/{runId}/retry #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/usedefinite-com:usedefinite-com-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

usedefinite-com-openapi-generated.yml Raw ↑
openapi: 3.1.0
info:
  title: Definite API
  version: '2026-10-29'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-29: 59 operation(s) read from 9 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Definite has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 0
    documentation: 59
    pages-with-code: 0
    pages-read: 9
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-29'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.usedefinite.com/api/vault
  - https://docs.usedefinite.com/api/decision-streams
  - https://docs.usedefinite.com/api/ledger-and-proofs
  - https://docs.usedefinite.com/api/siem-audit-export
  - https://docs.usedefinite.com/getting-started/verification-runs
  - https://docs.usedefinite.com/sdk/python
  - https://docs.usedefinite.com/sdk/typescript
  - https://docs.usedefinite.com/security/cryptography-and-tokens
  - https://docs.usedefinite.com/concepts/request-lifecycle
paths:
  /.well-known/jwks.json:
    get:
      operationId: get_well_known_jwks_json
      tags:
      - API
      summary: Signing keys
      x-source: https://docs.usedefinite.com/security/cryptography-and-tokens
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /decision-streams:
    get:
      operationId: get_decision_streams
      tags:
      - Decision Streams
      summary: List configured destinations with delivery stats.
      x-source: https://docs.usedefinite.com/api/decision-streams
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_decision_streams
      tags:
      - Decision Streams
      summary: Create a destination. Credentials are write-only and never returned.
      x-source: https://docs.usedefinite.com/api/decision-streams
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /decision-streams/deliveries/{deliveryid}/retry:
    post:
      operationId: post_decision_streams_deliveries_deliveryid_retry
      tags:
      - Decision Streams
      summary: Retry a failed delivery.
      x-source: https://docs.usedefinite.com/api/decision-streams
      parameters:
      - name: deliveryid
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /decision-streams/{destinationid}:
    delete:
      operationId: delete_decision_streams_destinationid
      tags:
      - Decision Streams
      summary: Delete a destination and its queued deliveries.
      x-source: https://docs.usedefinite.com/api/decision-streams
      parameters:
      - name: destinationid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    put:
      operationId: put_decision_streams_destinationid
      tags:
      - Decision Streams
      summary: Update configuration or enabled state.
      x-source: https://docs.usedefinite.com/api/decision-streams
      parameters:
      - name: destinationid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /decision-streams/{destinationid}/test:
    post:
      operationId: post_decision_streams_destinationid_test
      tags:
      - Decision Streams
      summary: Publish a synthetic test event.
      x-source: https://docs.usedefinite.com/api/decision-streams
      parameters:
      - name: destinationid
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /ledger:
    get:
      operationId: get_ledger
      tags:
      - Ledger
      summary: History
      x-source: https://docs.usedefinite.com/api/ledger-and-proofs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /ledger/checkpoints:
    get:
      operationId: get_ledger_checkpoints
      tags:
      - Ledger
      summary: History
      x-source: https://docs.usedefinite.com/api/ledger-and-proofs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /ledger/encrypted:
    get:
      operationId: get_ledger_encrypted
      tags:
      - Ledger
      summary: Advanced
      x-source: https://docs.usedefinite.com/api/ledger-and-proofs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /ledger/proof/bundle:
    get:
      operationId: get_ledger_proof_bundle
      tags:
      - Ledger
      summary: Verification
      x-source: https://docs.usedefinite.com/api/ledger-and-proofs
      parameters:
      - name: request_id
        in: query
        required: false
        schema:
          type: string
        description: Lookup key for the proof bundle
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /ledger/proof/consistency:
    get:
      operationId: get_ledger_proof_consistency
      tags:
      - Ledger
      summary: Verification
      x-source: https://docs.usedefinite.com/api/ledger-and-proofs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /ledger/proof/inclusion:
    get:
      operationId: get_ledger_proof_inclusion
      tags:
      - Ledger
      summary: Verification
      x-source: https://docs.usedefinite.com/api/ledger-and-proofs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /ledger/verification-summary:
    get:
      operationId: get_ledger_verification_summary
      tags:
      - Ledger
      summary: Verification
      x-source: https://docs.usedefinite.com/api/ledger-and-proofs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /ledger/verify:
    get:
      operationId: get_ledger_verify
      tags:
      - Ledger
      summary: Verification
      x-source: https://docs.usedefinite.com/api/ledger-and-proofs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /siem-exports:
    get:
      operationId: get_siem_exports
      tags:
      - Siem Exports
      summary: List configured destinations with delivery stats, last success, and last error.
      x-source: https://docs.usedefinite.com/api/siem-audit-export
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_siem_exports
      tags:
      - Siem Exports
      summary: Create a destination. Secrets are write‑only and stored in the tenant secret store.
      x-source: https://docs.usedefinite.com/api/siem-audit-export
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /siem-exports/{destinationid}:
    delete:
      operationId: delete_siem_exports_destinationid
      tags:
      - Siem Exports
      summary: Delete a destination.
      x-source: https://docs.usedefinite.com/api/siem-audit-export
      parameters:
      - name: destinationid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    put:
      operationId: put_siem_exports_destinationid
      tags:
      - Siem Exports
      summary: Update configuration or enabled state.
      x-source: https://docs.usedefinite.com/api/siem-audit-export
      parameters:
      - name: destinationid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /siem-exports/{destinationid}/replay:
    post:
      operationId: post_siem_exports_destinationid_replay
      tags:
      - Siem Exports
      summary: Re‑deliver records over a selected time window.
      x-source: https://docs.usedefinite.com/api/siem-audit-export
      parameters:
      - name: destinationid
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /siem-exports/{destinationid}/test:
    post:
      operationId: post_siem_exports_destinationid_test
      tags:
      - Siem Exports
      summary: Send a synthetic test record.
      x-source: https://docs.usedefinite.com/api/siem-audit-export
      parameters:
      - name: destinationid
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/artifacts:
    get:
      operationId: get_v1_artifacts
      tags:
      - Artifacts
      summary: GET /v1/artifacts , GET /v1/artifacts/{artifact_id} , GET /v1/artifacts/{artifact_id}/lineage
      x-source: https://docs.usedefinite.com/api/vault
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/artifacts/{artifactId}:
    get:
      operationId: get_v1_artifacts_artifactId
      tags:
      - Artifacts
      summary: GET /v1/artifacts , GET /v1/artifacts/{artifact_id} , GET /v1/artifacts/{artifact_id}/lineage
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: artifactId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/artifacts/{artifactId}/lineage:
    get:
      operationId: get_v1_artifacts_artifactId_lineage
      tags:
      - Artifacts
      summary: GET /v1.artifacts , GET /v1/artifacts/{artifact_id} , GET /v1/artifacts/{artifact_id}/lineage
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: artifactId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/data-sources:
    get:
      operationId: get_v1_data_sources
      tags:
      - Data Sources
      summary: GET /v1/data-sources — connected sources with freshness ( current , late , missing , error , not_configured ).
      x-source: https://docs.usedefinite.com/api/vault
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/exceptions:
    get:
      operationId: get_v1_exceptions
      tags:
      - Exceptions
      summary: 'Exception states: open , investigating , awaiting_human , resolved . Reviewer identity comes from the authenticated session at
        the console boundary; client-supplied reviewer identities are rejected.'
      x-source: https://docs.usedefinite.com/api/vault
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/exceptions/{exceptionId}:
    get:
      operationId: get_v1_exceptions_exceptionId
      tags:
      - Exceptions
      summary: 'Exception states: open , investigating , awaiting_human , resolved . Reviewer identity comes from the authenticated session at
        the console boundary; client-supplied reviewer identities are rejected.'
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: exceptionId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    patch:
      operationId: patch_v1_exceptions_exceptionId
      tags:
      - Exceptions
      summary: 'Exception states: open , investigating , awaiting_human , resolved . Reviewer identity comes from the authenticated session at
        the console boundary; client-supplied reviewer identities are rejected.'
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: exceptionId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/exceptions/{exceptionId}/reviews:
    post:
      operationId: post_v1_exceptions_exceptionId_reviews
      tags:
      - Exceptions
      summary: 'Exception states: open , investigating , awaiting_human , resolved . Reviewer identity comes from the authenticated session at
        the console boundary; client-supplied reviewer identities are rejected.'
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: exceptionId
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/form-definitions:
    get:
      operationId: get_v1_form_definitions
      tags:
      - Form Definitions
      summary: Definitions
      x-source: https://docs.usedefinite.com/api/vault
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/form-definitions/{definitionId}:
    get:
      operationId: get_v1_form_definitions_definitionId
      tags:
      - Form Definitions
      summary: Definitions
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: definitionId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/mapping-proposals/{proposalId}:
    get:
      operationId: get_v1_mapping_proposals_proposalId
      tags:
      - Mapping Proposals
      summary: Agent-proposed mappings are versioned and reviewed; proposal states are pending , approved , rejected , and changes_requested .
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: proposalId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/mapping-proposals/{proposalId}/activate:
    post:
      operationId: post_v1_mapping_proposals_proposalId_activate
      tags:
      - Mapping Proposals
      summary: Agent-proposed mappings are versioned and reviewed; proposal states are pending , approved , rejected , and changes_requested .
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: proposalId
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/mapping-proposals/{proposalId}/reviews:
    post:
      operationId: post_v1_mapping_proposals_proposalId_reviews
      tags:
      - Mapping Proposals
      summary: Agent-proposed mappings are versioned and reviewed; proposal states are pending , approved , rejected , and changes_requested .
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: proposalId
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/programs:
    get:
      operationId: get_v1_programs
      tags:
      - Programs
      summary: Programs and runs
      x-source: https://docs.usedefinite.com/api/vault
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_v1_programs
      tags:
      - Programs
      summary: Programs and runs
      x-source: https://docs.usedefinite.com/api/vault
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/programs/{programId}:
    get:
      operationId: get_v1_programs_programId
      tags:
      - Programs
      summary: Programs and runs
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: programId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/programs/{programId}/mapping-proposals:
    get:
      operationId: get_v1_programs_programId_mapping_proposals
      tags:
      - Programs
      summary: Agent-proposed mappings are versioned and reviewed; proposal states are pending , approved , rejected , and changes_requested .
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: programId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/programs/{programId}/run-groups:
    post:
      operationId: post_v1_programs_programId_run_groups
      tags:
      - Programs
      summary: Programs and runs
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: programId
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/programs/{programId}/runs:
    post:
      operationId: post_v1_programs_programId_runs
      tags:
      - Programs
      summary: Programs and runs
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: programId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ProgramsProgramidRunsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1ProgramsProgramidRunsResponse'
      x-evidence:
        kind: documentation
  /v1/readiness:
    get:
      operationId: get_v1_readiness
      tags:
      - Readiness
      summary: verdict counts, active runs, open exceptions, missing inputs, ledger integrity, program status. Metadata, never a verdict.
      x-source: https://docs.usedefinite.com/api/vault
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/receipts:
    get:
      operationId: get_v1_receipts
      tags:
      - Receipts
      summary: signed rule receipts.
      x-source: https://docs.usedefinite.com/api/vault
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/receipts/{receiptId}:
    get:
      operationId: get_v1_receipts_receiptId
      tags:
      - Receipts
      summary: signed rule receipts.
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: receiptId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/reporting-entities:
    get:
      operationId: get_v1_reporting_entities
      tags:
      - Reporting Entities
      summary: Readiness and portfolio
      x-source: https://docs.usedefinite.com/api/vault
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/reporting-entities/{entityId}/form-obligations:
    get:
      operationId: get_v1_reporting_entities_entityId_form_obligations
      tags:
      - Reporting Entities
      summary: Readiness and portfolio
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: entityId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/reporting-portfolio:
    get:
      operationId: get_v1_reporting_portfolio
      tags:
      - Reporting Portfolio
      summary: Readiness and portfolio
      x-source: https://docs.usedefinite.com/api/vault
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/runs:
    get:
      operationId: get_v1_runs
      tags:
      - Runs
      summary: Programs and runs
      x-source: https://docs.usedefinite.com/api/vault
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/runs/{runId}:
    get:
      operationId: get_v1_runs_runId
      tags:
      - Runs
      summary: GET /v1/runs/{runId}
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: runId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/runs/{runId}/adjustments:
    get:
      operationId: get_v1_runs_runId_adjustments
      tags:
      - Runs
      summary: GET /v1/runs/{runId}/adjustments
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: runId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_v1_runs_runId_adjustments
      tags:
      - Runs
      summary: POST /v1/runs/{runId}/adjustments
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: runId
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/runs/{runId}/agent-evidence-selections:
    get:
      operationId: get_v1_runs_runId_agent_evidence_selections
      tags:
      - Runs
      summary: GET /v1/runs/{runId}/agent-evidence-selections
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: runId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/runs/{runId}/cells:
    get:
      operationId: get_v1_runs_runId_cells
      tags:
      - Runs
      summary: GET /v1/runs/{runId}/cells
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: runId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/runs/{runId}/cells/{conceptId}:
    get:
      operationId: get_v1_runs_runId_cells_conceptId
      tags:
      - Runs
      summary: GET /v1/runs/{runId}/cells/{conceptId}
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: runId
        in: path
        required: true
        schema:
          type: string
      - name: conceptId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/runs/{runId}/events:
    get:
      operationId: get_v1_runs_runId_events
      tags:
      - Runs
      summary: Immutable stage telemetry.
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: runId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/runs/{runId}/exports:
    get:
      operationId: get_v1_runs_runId_exports
      tags:
      - Runs
      summary: Read‑only over API keys; authorizing a final export is a console action by an admin or owner.
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: runId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/runs/{runId}/final-evidence:
    get:
      operationId: get_v1_runs_runId_final_evidence
      tags:
      - Runs
      summary: GET /v1/runs/{runId}/final-evidence
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: runId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/runs/{runId}/inputs:
    get:
      operationId: get_v1_runs_runId_inputs
      tags:
      - Runs
      summary: GET /v1/runs/{runId}/inputs
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: runId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/runs/{runId}/reconciliations:
    get:
      operationId: get_v1_runs_runId_reconciliations
      tags:
      - Runs
      summary: GET /v1/runs/{runId}/reconciliations
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: runId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/runs/{runId}/retry:
    post:
      operationId: post_v1_runs_runId_retry
      tags:
      - Runs
      summary: POST /v1/runs/{runId}/retry
      x-source: https://docs.usedefinite.com/api/vault
      parameters:
      - name: runId
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostV1ProgramsProgramidRunsRequest:
      type: object
      properties:
        idempotency_key:
          type: string
          description: required
        trigger:
          type: string
          description: manual
        reporting_entity_id:
          type: string
        form_id:
          type: string
        form_version:
          type: string
        reporting_period:
          type: string
        as_of:
          type: string
      required:
      - idempotency_key
    PostV1ProgramsProgramidRunsResponse:
      type: object
      properties:
        status:
          type: integer
          description: 202 with a queued run
  securitySchemes:
    X-Vault-API-Key:
      type: apiKey
      in: header
      name: X-Vault-API-Key
      x-source: https://docs.usedefinite.com/security/cryptography-and-tokens
tags:
- name: API
- name: Artifacts
- name: Data Sources
- name: Decision Streams
- name: Exceptions
- name: Form Definitions
- name: Ledger
- name: Mapping Proposals
- name: Programs
- name: Readiness
- name: Receipts
- name: Reporting Entities
- name: Reporting Portfolio
- name: Runs
- name: Siem Exports
security:
- X-Vault-API-Key: []