How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

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.

Definite API is one of 2 APIs that Definite publishes on the 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.

This API exposes 59 operations across 52 paths, organized into 15 resource areas, and defines 2 schemas. It is described by OpenAPI 3.1.0, at version 2026-10-29.

59 operations 52 paths 2 schemas 2 DELETE40 GET1 PATCH14 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2026-10-29
Authentication
API Key
Resource Areas
15

Authentication & Security 1

Definite API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Vault-API-Key (X-Vault-API-Key). By default, every request must be authenticated.

Paths & Operations 59

Across 52 paths, the API surfaces 59 operations — 2 DELETE, 40 GET, 1 PATCH, 14 POST, 2 PUT. They span 15 resource areas, including API, Decision Streams, Ledger, Siem Exports, Artifacts, Data Sources, Exceptions, Form Definitions, and 7 more. Each is listed below with its method, path, parameters, and response codes.

API 1
GET
/.well-known/jwks.json
Signing keys
get_well_known_jwks_json → 200
Decision Streams 6
GET
/decision-streams
List configured destinations with delivery stats.
get_decision_streams → 200
POST
/decision-streams
Create a destination. Credentials are write-only and never returned.
post_decision_streams → 201
POST
/decision-streams/deliveries/{deliveryid}/retry
Retry a failed delivery.
post_decision_streams_deliveries_deliveryid_retry 1 param → 201
DELETE
/decision-streams/{destinationid}
Delete a destination and its queued deliveries.
delete_decision_streams_destinationid 1 param → 200
PUT
/decision-streams/{destinationid}
Update configuration or enabled state.
put_decision_streams_destinationid 1 param → 200
POST
/decision-streams/{destinationid}/test
Publish a synthetic test event.
post_decision_streams_destinationid_test 1 param → 201
Ledger 8
GET
/ledger
History
get_ledger → 200
GET
/ledger/checkpoints
History
get_ledger_checkpoints → 200
GET
/ledger/encrypted
Advanced
get_ledger_encrypted → 200
GET
/ledger/proof/bundle
Verification
get_ledger_proof_bundle 1 param → 200
GET
/ledger/proof/consistency
Verification
get_ledger_proof_consistency → 200
GET
/ledger/proof/inclusion
Verification
get_ledger_proof_inclusion → 200
GET
/ledger/verification-summary
Verification
get_ledger_verification_summary → 200
GET
/ledger/verify
Verification
get_ledger_verify → 200
Siem Exports 6
GET
/siem-exports
List configured destinations with delivery stats, last success, and last error.
get_siem_exports → 200
POST
/siem-exports
Create a destination. Secrets are write‑only and stored in the tenant secret store.
post_siem_exports → 201
DELETE
/siem-exports/{destinationid}
Delete a destination.
delete_siem_exports_destinationid 1 param → 200
PUT
/siem-exports/{destinationid}
Update configuration or enabled state.
put_siem_exports_destinationid 1 param → 200
POST
/siem-exports/{destinationid}/replay
Re‑deliver records over a selected time window.
post_siem_exports_destinationid_replay 1 param → 201
POST
/siem-exports/{destinationid}/test
Send a synthetic test record.
post_siem_exports_destinationid_test 1 param → 201
Artifacts 3
GET
/v1/artifacts
GET /v1/artifacts , GET /v1/artifacts/{artifactid} , GET /v1/artifacts/{artifactid}/lineage
get_v1_artifacts → 200
GET
/v1/artifacts/{artifactId}
GET /v1/artifacts , GET /v1/artifacts/{artifactid} , GET /v1/artifacts/{artifactid}/lineage
get_v1_artifacts_artifactId 1 param → 200
GET
/v1/artifacts/{artifactId}/lineage
GET /v1.artifacts , GET /v1/artifacts/{artifactid} , GET /v1/artifacts/{artifactid}/lineage
get_v1_artifacts_artifactId_lineage 1 param → 200
Data Sources 1
GET
/v1/data-sources
GET /v1/data-sources — connected sources with freshness ( current , late , missing , error , notconfigured ).
get_v1_data_sources → 200
Exceptions 4
GET
/v1/exceptions
Exception states: open , investigating , awaitinghuman , resolved . Reviewer identity comes from the authenticated session at the console boundary; client-supplied reviewer identities are rejected.
get_v1_exceptions → 200
GET
/v1/exceptions/{exceptionId}
Exception states: open , investigating , awaitinghuman , resolved . Reviewer identity comes from the authenticated session at the console boundary; client-supplied reviewer identities are rejected.
get_v1_exceptions_exceptionId 1 param → 200
PATCH
/v1/exceptions/{exceptionId}
Exception states: open , investigating , awaitinghuman , resolved . Reviewer identity comes from the authenticated session at the console boundary; client-supplied reviewer identities are rejected.
patch_v1_exceptions_exceptionId 1 param → 200
POST
/v1/exceptions/{exceptionId}/reviews
Exception states: open , investigating , awaitinghuman , resolved . Reviewer identity comes from the authenticated session at the console boundary; client-supplied reviewer identities are rejected.
post_v1_exceptions_exceptionId_reviews 1 param → 201
Form Definitions 2
GET
/v1/form-definitions
Definitions
get_v1_form_definitions → 200
GET
/v1/form-definitions/{definitionId}
Definitions
get_v1_form_definitions_definitionId 1 param → 200
Mapping Proposals 3
GET
/v1/mapping-proposals/{proposalId}
Agent-proposed mappings are versioned and reviewed; proposal states are pending , approved , rejected , and changesrequested .
get_v1_mapping_proposals_proposalId 1 param → 200
POST
/v1/mapping-proposals/{proposalId}/activate
Agent-proposed mappings are versioned and reviewed; proposal states are pending , approved , rejected , and changesrequested .
post_v1_mapping_proposals_proposalId_activate 1 param → 201
POST
/v1/mapping-proposals/{proposalId}/reviews
Agent-proposed mappings are versioned and reviewed; proposal states are pending , approved , rejected , and changesrequested .
post_v1_mapping_proposals_proposalId_reviews 1 param → 201
Programs 6
GET
/v1/programs
Programs and runs
get_v1_programs → 200
POST
/v1/programs
Programs and runs
post_v1_programs → 201
GET
/v1/programs/{programId}
Programs and runs
get_v1_programs_programId 1 param → 200
GET
/v1/programs/{programId}/mapping-proposals
Agent-proposed mappings are versioned and reviewed; proposal states are pending , approved , rejected , and changesrequested .
get_v1_programs_programId_mapping_proposals 1 param → 200
POST
/v1/programs/{programId}/run-groups
Programs and runs
post_v1_programs_programId_run_groups 1 param → 201
POST
/v1/programs/{programId}/runs
Programs and runs
post_v1_programs_programId_runs 1 param body → 201
Readiness 1
GET
/v1/readiness
verdict counts, active runs, open exceptions, missing inputs, ledger integrity, program status. Metadata, never a verdict.
get_v1_readiness → 200
Receipts 2
GET
/v1/receipts
signed rule receipts.
get_v1_receipts → 200
GET
/v1/receipts/{receiptId}
signed rule receipts.
get_v1_receipts_receiptId 1 param → 200
Reporting Entities 2
GET
/v1/reporting-entities
Readiness and portfolio
get_v1_reporting_entities → 200
GET
/v1/reporting-entities/{entityId}/form-obligations
Readiness and portfolio
get_v1_reporting_entities_entityId_form_obligations 1 param → 200
Reporting Portfolio 1
GET
/v1/reporting-portfolio
Readiness and portfolio
get_v1_reporting_portfolio → 200
Runs 13
GET
/v1/runs
Programs and runs
get_v1_runs → 200
GET
/v1/runs/{runId}
GET /v1/runs/{runId}
get_v1_runs_runId 1 param → 200
GET
/v1/runs/{runId}/adjustments
GET /v1/runs/{runId}/adjustments
get_v1_runs_runId_adjustments 1 param → 200
POST
/v1/runs/{runId}/adjustments
POST /v1/runs/{runId}/adjustments
post_v1_runs_runId_adjustments 1 param → 201
GET
/v1/runs/{runId}/agent-evidence-selections
GET /v1/runs/{runId}/agent-evidence-selections
get_v1_runs_runId_agent_evidence_selections 1 param → 200
GET
/v1/runs/{runId}/cells
GET /v1/runs/{runId}/cells
get_v1_runs_runId_cells 1 param → 200
GET
/v1/runs/{runId}/cells/{conceptId}
GET /v1/runs/{runId}/cells/{conceptId}
get_v1_runs_runId_cells_conceptId 2 params → 200
GET
/v1/runs/{runId}/events
Immutable stage telemetry.
get_v1_runs_runId_events 1 param → 200
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_exports 1 param → 200
GET
/v1/runs/{runId}/final-evidence
GET /v1/runs/{runId}/final-evidence
get_v1_runs_runId_final_evidence 1 param → 200
GET
/v1/runs/{runId}/inputs
GET /v1/runs/{runId}/inputs
get_v1_runs_runId_inputs 1 param → 200
GET
/v1/runs/{runId}/reconciliations
GET /v1/runs/{runId}/reconciliations
get_v1_runs_runId_reconciliations 1 param → 200
POST
/v1/runs/{runId}/retry
POST /v1/runs/{runId}/retry
post_v1_runs_runId_retry 1 param → 201

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are PostV1ProgramsProgramidRunsRequest (7 properties), PostV1ProgramsProgramidRunsResponse (1 property). Each schema is shown below with its type and property counts.

PostV1ProgramsProgramidRunsRequest
object
7 properties 1 required
PostV1ProgramsProgramidRunsResponse
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

usedefinite-com-openapi-generated.yml Raw ↑

Other APIs Definite publishes across the network.

Definite API
Where this information came from

This is an independent, third-party profile of Definite API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.