decide-fyi Outcome Tracking API
Report and read what happened after a Decision Record authorized or routed an action.
Report and read what happened after a Decision Record authorized or routed an action.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/decide-fyi:decide-fyi-outcome-tracking-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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: 3.2.0
info:
title: Decide Decision Outcome Tracking API
summary: Decision protocol for state-changing software actions.
description: Call Decide before products, agents, queues, billing systems, CRMs, or internal tools change state. The API returns a signed Decision Record v1 object with policy bundle attestation, evidence, action binding, replay, verification handles, portable Decision Packet v1 exports, simulation-only counterfactual analysis, cryptographic audit chains, Action Execution Receipts, Outcome Records, CRM Sync Records, predictive confidence, first-party policy pattern templates, policy effectiveness metrics, opt-in anonymized benchmarks, and explainable anomaly reports derived from reported outcomes.
version: 1.13.0
x-decision-protocol-version: decision_protocol_v1
x-decision-record-version: decision_record_v1
x-decision-packet-version: decision_packet_v1
servers:
- url: https://www.decide.fyi
description: Production
security:
- ApiKeyAuth: []
tags:
- name: Outcome Tracking
description: Report and read what happened after a Decision Record authorized or routed an action.
paths:
/api/decision/{decision_id}/outcome:
post:
tags:
- Outcome Tracking
operationId: recordDecisionOutcome
summary: Record a Decision Outcome
description: 'Creates a hashed Outcome Record linked to the original Decision Record. Keyed writes are atomically claimed: the same key plus the same canonical outcome payload replays the original outcome, a concurrent request returns 409 in progress, and the same key plus a different payload returns 409 conflict. Authoritative storage and idempotency failures return 503 without acknowledging an untracked outcome.'
parameters:
- $ref: '#/components/parameters/DecisionId'
- $ref: '#/components/parameters/IdempotencyKey'
- $ref: '#/components/parameters/RequestId'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DecisionOutcomeRequest'
examples:
billingMutation:
summary: Billing mutation outcome
value:
outcome_status: succeeded
action_taken: apply_discount
action_executed: true
target_system: billing
target_object_id: sub_1042
mutation: discount.create
external_ref: bill_1042
decision_record_hash: 7f3a...
decision_receipt_hash: c91e...
observed_metrics:
margin_after_discount: 0.182
responses:
'200':
description: Idempotent replay of an existing Decision Outcome
content:
application/json:
schema:
$ref: '#/components/schemas/DecisionOutcomeResult'
'201':
description: Decision Outcome recorded
headers:
x-decision-outcome-id:
schema:
type: string
x-decision-outcome-hash:
schema:
type: string
x-idempotency-status:
schema:
type: string
enum:
- created
- replayed
content:
application/json:
schema:
$ref: '#/components/schemas/DecisionOutcomeResult'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: Decision not found in the authenticated caller scope
'409':
$ref: '#/components/responses/IdempotencyConflict'
'503':
$ref: '#/components/responses/ServiceUnavailable'
get:
tags:
- Outcome Tracking
operationId: listDecisionOutcomes
summary: List Decision Outcomes for a decision
parameters:
- $ref: '#/components/parameters/DecisionId'
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 1000
responses:
'200':
description: Decision Outcome list
content:
application/json:
schema:
type: object
required:
- ok
- decision_id
- count
- outcomes
properties:
ok:
type: boolean
decision_id:
type: string
count:
type: integer
outcomes:
type: array
items:
$ref: '#/components/schemas/DecisionOutcome'
additionalProperties: true
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: Decision not found in the authenticated caller scope
'503':
$ref: '#/components/responses/ServiceUnavailable'
components:
schemas:
DecisionOutcome:
type: object
required:
- decision_protocol_version
- decision_outcome_version
- outcome_id
- decision_id
- outcome_status
- outcome_hash
- reported_at
properties:
decision_protocol_version:
type: string
const: decision_protocol_v1
decision_outcome_version:
type: string
const: decision_outcome_v1
outcome_id:
type: string
decision_id:
type: string
idempotency_key:
type: string
outcome_status:
type: string
action_executed:
type: boolean
action_taken:
type: string
target_system:
type: string
target_object_id:
type: string
mutation:
type: string
external_ref:
type: string
decision_record_hash:
type: string
decision_receipt_hash:
type: string
decision_verdict:
type: string
decision_action:
type: string
policy_id:
type: string
policy_version:
type: string
policy_bundle_hash:
type: string
action_binding:
$ref: '#/components/schemas/ActionBinding'
observed_metrics:
type: object
additionalProperties: true
evidence_refs:
type: array
items:
type: object
additionalProperties: true
outcome_input_hash:
type: string
outcome_hash:
type: string
integrity:
type: object
additionalProperties: true
executed_at:
type: string
reported_at:
type: string
decision_found:
type: boolean
decision_url:
type: string
verify_url:
type: string
additionalProperties: true
ActionBinding:
type: object
properties:
actor:
type: string
system:
type: string
resource:
type: string
proposed_action:
type: string
subject:
type: string
amount:
type: string
currency:
type: string
target_system:
type: string
target_object_id:
type: string
mutation:
type: string
expires_at:
type: string
execution_state:
type: string
execution_id:
type: string
additionalProperties: true
ErrorResponse:
type: object
properties:
c:
type: string
v:
type: string
request_id:
type: string
error:
type: string
message:
type: string
additionalProperties: true
DecisionOutcomeRequest:
type: object
required:
- outcome_status
properties:
decision_id:
type: string
maxLength: 600
outcome_status:
type: string
description: Normalized to succeeded, failed, reverted, reviewed, skipped, unknown, or a compact custom status.
action_taken:
type: string
action_executed:
type: boolean
target_system:
type: string
target_object_id:
type: string
mutation:
type: string
external_ref:
type: string
decision_record_hash:
type: string
decision_receipt_hash:
type: string
observed_metrics:
type: object
additionalProperties: true
evidence_refs:
type: array
items:
type:
- object
- string
additionalProperties: true
executed_at:
type: string
reported_at:
type: string
additionalProperties: true
DecisionOutcomeResult:
type: object
required:
- ok
- decision_id
- outcome
properties:
ok:
type: boolean
idempotency_status:
type: string
decision_id:
type: string
outcome:
$ref: '#/components/schemas/DecisionOutcome'
additionalProperties: true
responses:
IdempotencyConflict:
description: The idempotency key is already in progress, or it was reused with a different canonical payload
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Unauthorized:
description: API key missing, invalid, inactive, or unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
ServiceUnavailable:
description: Decision storage or the upstream decision engine timed out or is temporarily unavailable
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
parameters:
DecisionId:
name: decision_id
in: path
required: true
schema:
type: string
maxLength: 600
RequestId:
name: x-request-id
in: header
required: false
schema:
type: string
maxLength: 160
IdempotencyKey:
name: x-idempotency-key
in: header
required: false
schema:
type: string
maxLength: 300
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key