Skip to main content
POST
Explain Neon decision

Authorizations

Authorization
string
header
required

Bearer token: an organization API key (ak_…) created under Settings → API Keys, or a dashboard user session token. Agent keys (xe_…) are not accepted here. Endpoints marked as user-only in their description reject organization keys with 403.

Path Parameters

decision_id
string
required
Pattern: ^dec_[0-9a-f]{6,32}$
agent_id
string<uuid>
required

Body

application/json
question
string | null
Maximum string length: 160
Pattern: ^(\*|(risk|violation)[.:][A-Za-z0-9_.:()-]*)$

Response

Successful Response

Neon's explanation of one question of a logged decision: the span of the event that shows it (fired) or came closest (not fired), and why.

decision_id
string
required
question
string
required
fired
boolean
required
probability
number | null
action
string | null
label
string | null
quote
string | null
verified
boolean
default:false
reason
string | null
cached
boolean
default:false