# Definite API **Canonical:** https://apis.io/apis/usedefinite-com/usedefinite-com-api/ **Provider:** Definite — https://apis.io/providers/usedefinite-com/ **Documentation:** https://docs.usedefinite.com/api/vault Definite API is one of 2 APIs that [Definite](https://apis.io/providers/usedefinite-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 2 JSON Schemas. 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) | Method | Path | Summary | |---|---|---| | 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-s... | | GET | `/v1/exceptions/{exceptionId}` | Exception states: open , investigating , awaiting_human , resolved . Reviewer identity comes from the authenticated session at the console boundary; client-s... | | PATCH | `/v1/exceptions/{exceptionId}` | Exception states: open , investigating , awaiting_human , resolved . Reviewer identity comes from the authenticated session at the console boundary; client-s... | | POST | `/v1/exceptions/{exceptionId}/reviews` | Exception states: open , investigating , awaiting_human , resolved . Reviewer identity comes from the authenticated session at the console boundary; client-s... | | 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 | ## Machine-readable artifacts (3) - **OpenAPI** — https://artifacts.apis.io/usedefinite-com/openapi/_ae-authored/usedefinite-com-openapi-generated.yml - **JSONSchema** — https://artifacts.apis.io/usedefinite-com/json-schema/usedefinite-com-post-v1-programs-programid-runs-request-schema.json - **JSONSchema** — https://artifacts.apis.io/usedefinite-com/json-schema/usedefinite-com-post-v1-programs-programid-runs-response-schema.json ## Other Definite APIs (1) - [Definite API](https://apis.io/apis/usedefinite-com/definite-api/) --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/usedefinite-com/usedefinite-com-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/usedefinite-com/.