decide-fyi Anomalies API
Explainable outcome-based anomaly reports scoped to the caller API key.
Explainable outcome-based anomaly reports scoped to the caller API key.
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-anomalies-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 Anomalies 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: Anomalies
description: Explainable outcome-based anomaly reports scoped to the caller API key.
paths:
/api/decision/policies/{policy_id}/anomalies:
get:
tags:
- Anomalies
operationId: getPolicyAnomalies
summary: Read outcome-based policy anomalies
description: Returns decision_anomaly_report_v1 derived from the latest Decision Outcome per decision within the caller API-key scope. Scores are deterministic outcome-signal heuristics with explainable reason codes, not model predictions.
parameters:
- name: policy_id
in: path
required: true
schema:
type: string
maxLength: 180
- name: policy_version
in: query
required: false
schema:
type: string
maxLength: 180
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100000
default: 1000
- name: min_sample
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100000
default: 10
- name: threshold
in: query
required: false
schema:
type: number
minimum: 0
maximum: 1
default: 0.35
- name: max_items
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 500
default: 25
responses:
'200':
description: Policy anomaly report
content:
application/json:
schema:
$ref: '#/components/schemas/PolicyAnomalyReport'
'401':
$ref: '#/components/responses/Unauthorized'
components:
schemas:
PolicyAnomaly:
type: object
required:
- decision_id
- outcome_id
- anomaly_score
- severity
- reasons
properties:
decision_id:
type: string
outcome_id:
type: string
anomaly_score:
type: number
severity:
type: string
enum:
- normal
- low
- medium
- high
reasons:
type: array
items:
$ref: '#/components/schemas/PolicyAnomalyReason'
decision_verdict:
type: string
outcome_status:
type: string
action_executed:
type:
- boolean
- 'null'
policy_id:
type: string
policy_version:
type:
- string
- 'null'
target_system:
type:
- string
- 'null'
target_object_id:
type:
- string
- 'null'
mutation:
type:
- string
- 'null'
reported_at:
type:
- string
- 'null'
outcome_hash:
type:
- string
- 'null'
decision_url:
type:
- string
- 'null'
verify_url:
type:
- string
- 'null'
additionalProperties: true
PolicyAnomalyReason:
type: object
required:
- code
- message
- weight
properties:
code:
type: string
message:
type: string
weight:
type: number
observed:
type: object
additionalProperties: true
baseline:
type: object
additionalProperties: true
additionalProperties: true
ErrorResponse:
type: object
properties:
c:
type: string
v:
type: string
request_id:
type: string
error:
type: string
message:
type: string
additionalProperties: true
PolicyAnomalyReport:
type: object
required:
- ok
- decision_anomaly_report_version
- policy_id
- decisions_analyzed
- summary
- baseline
- anomalies
- anomaly_hash
- recommendation
properties:
ok:
type: boolean
decision_anomaly_report_version:
type: string
const: decision_anomaly_report_v1
generated_at:
type: string
policy_id:
type: string
policy_version:
type:
- string
- 'null'
source:
type: string
const: decision_outcomes
minimum_sample_size:
type: integer
anomaly_threshold:
type: number
max_anomalies_returned:
type: integer
decisions_analyzed:
type: integer
outcomes_analyzed:
type: integer
distinct_decisions:
type: integer
status:
type: string
enum:
- scored
- insufficient_data
recommendation:
type: string
enum:
- collect_more_outcomes
- review_high_anomalies
- monitor_anomalies
- stable
summary:
type: object
properties:
anomaly_count:
type: integer
returned_count:
type: integer
high_count:
type: integer
medium_count:
type: integer
low_count:
type: integer
max_score:
type:
- number
- 'null'
additionalProperties: true
baseline:
type: object
additionalProperties: true
anomalies:
type: array
items:
$ref: '#/components/schemas/PolicyAnomaly'
window:
type: object
additionalProperties: true
data_quality:
type: object
additionalProperties: true
anomaly_hash:
type: string
additionalProperties: true
responses:
Unauthorized:
description: API key missing, invalid, inactive, or unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key