decide-fyi Action Execution API
Record target-system neutral receipts proving whether the action authorized by a Decision Record was executed, skipped, failed, blocked, or reverted.
Record target-system neutral receipts proving whether the action authorized by a Decision Record was executed, skipped, failed, blocked, or reverted.
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-action-execution-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 Action Execution 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: Action Execution
description: Record target-system neutral receipts proving whether the action authorized by a Decision Record was executed, skipped, failed, blocked, or reverted.
paths:
/api/decision/{decision_id}/execution:
post:
tags:
- Action Execution
operationId: recordDecisionExecution
summary: Record a Decision Action Execution receipt
description: 'Creates a hashed Action Execution Receipt linked to the original Decision Record and action binding. Keyed writes are atomically claimed: the same key plus the same canonical execution payload replays the original receipt, 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 receipt.'
parameters:
- $ref: '#/components/parameters/DecisionId'
- $ref: '#/components/parameters/IdempotencyKey'
- $ref: '#/components/parameters/RequestId'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DecisionExecutionRequest'
examples:
billingExecution:
summary: Billing mutation execution receipt
value:
execution_status: executed
action_taken: apply_discount
target_system: billing
target_object_id: sub_1042
mutation: discount.create
execution_id: billing_run_1042
external_ref: bill_1042
decision_record_hash: 7f3a...
decision_receipt_hash: c91e...
state_before_hash: sha256:subscription_before_1042
state_after_hash: sha256:subscription_after_1042
executor:
type: service
id: billing-worker
responses:
'200':
description: Idempotent replay of an existing Action Execution Receipt
content:
application/json:
schema:
$ref: '#/components/schemas/DecisionExecutionResult'
'201':
description: Action Execution Receipt recorded
headers:
x-decision-execution-id:
schema:
type: string
x-decision-execution-hash:
schema:
type: string
x-idempotency-status:
schema:
type: string
enum:
- created
- replayed
content:
application/json:
schema:
$ref: '#/components/schemas/DecisionExecutionResult'
'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:
- Action Execution
operationId: listDecisionExecutions
summary: List Action Execution Receipts for a decision
parameters:
- $ref: '#/components/parameters/DecisionId'
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 1000
responses:
'200':
description: Action Execution Receipt list
content:
application/json:
schema:
type: object
required:
- ok
- decision_id
- count
- executions
properties:
ok:
type: boolean
decision_id:
type: string
count:
type: integer
executions:
type: array
items:
$ref: '#/components/schemas/DecisionExecution'
additionalProperties: true
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: Decision not found in the authenticated caller scope
'503':
$ref: '#/components/responses/ServiceUnavailable'
components:
schemas:
DecisionExecution:
type: object
required:
- decision_protocol_version
- decision_execution_version
- execution_receipt_id
- decision_id
- execution_status
- execution_hash
- reported_at
properties:
decision_protocol_version:
type: string
const: decision_protocol_v1
decision_execution_version:
type: string
const: decision_execution_v1
execution_receipt_id:
type: string
decision_id:
type: string
idempotency_key:
type: string
execution_status:
type: string
execution_result:
type: string
action_taken:
type: string
target_system:
type: string
target_object_id:
type: string
mutation:
type: string
external_ref:
type: string
execution_id:
type: string
executor:
type: object
additionalProperties: true
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'
action_binding_hash:
type: string
action_binding_match:
type:
- boolean
- 'null'
state_before_hash:
type: string
state_after_hash:
type: string
state_before_ref:
type: string
state_after_ref:
type: string
evidence_refs:
type: array
items:
type: object
additionalProperties: true
execution_input_hash:
type: string
execution_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
ErrorResponse:
type: object
properties:
c:
type: string
v:
type: string
request_id:
type: string
error:
type: string
message:
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
DecisionExecutionRequest:
type: object
required:
- execution_status
properties:
decision_id:
type: string
maxLength: 600
execution_status:
type: string
description: Normalized to queued, executed, failed, skipped, reverted, blocked, reviewed, unknown, or a compact custom status.
execution_result:
type: string
action_taken:
type: string
target_system:
type: string
target_object_id:
type: string
mutation:
type: string
execution_id:
type: string
external_ref:
type: string
executor:
type: object
additionalProperties: true
decision_record_hash:
type: string
decision_receipt_hash:
type: string
action_binding:
$ref: '#/components/schemas/ActionBinding'
action_binding_hash:
type: string
state_before_hash:
type: string
state_after_hash:
type: string
state_before_ref:
type: string
state_after_ref:
type: string
evidence_refs:
type: array
items:
type:
- object
- string
additionalProperties: true
executed_at:
type: string
reported_at:
type: string
additionalProperties: true
DecisionExecutionResult:
type: object
required:
- ok
- decision_id
- execution
properties:
ok:
type: boolean
idempotency_status:
type: string
decision_id:
type: string
execution:
$ref: '#/components/schemas/DecisionExecution'
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