Full decision provenance

GET

/api/v1/decisions/{decision_id}/detail

• Production
• Local development

Returns the complete provenance trail for a single decision, including full reasoning chain, all data sources consulted, expected vs actual outcomes, and confidence calibration.

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

decision_id

required

The decision UUID to retrieve

string

The decision UUID to retrieve

Responses

200

Successful Response

Full provenance response for a single decision.

Attributes: id: Decision UUID. tenant_id: Owning tenant. agent_role: The agent that made the decision. action_type: Category of action. autonomy_level: Autonomy level used. description: Human-readable description. reasoning_chain: Full reasoning trace. confidence_score: Agent confidence (0.0-1.0). data_sources: All data sources consulted. expected_outcome: What the agent predicted. actual_outcome: What actually happened. outcome_quality: Match score. outcome_measured_at: When outcome was measured. status: Decision status. reversible: Whether decision can be undone. reversed: Whether decision was undone. created_at: When recorded. decided_at: When executed. signature: Ed25519 signature if signed. signature_algorithm: Signing algorithm. signed_at_sig: When the signature was created. signer_certificate_id: UUID of the signing certificate. signer_fingerprint: Certificate fingerprint at signing time.

object

action_type

required

string

actual_outcome

required

Any of:

object

object

key

additional properties

any

null

null

agent_role

required

string

autonomy_level

required

integer

confidence_score

required

Any of:

number

number

null

null

created_at

required

string format: date-time

data_sources

required

Array<object>

object

key

additional properties

any

decided_at

required

Any of:

string

string format: date-time

null

null

description

required

string

expected_outcome

required

Any of:

object

object

key

additional properties

any

null

null

id

required

string

outcome_measured_at

required

Any of:

string

string format: date-time

null

null

outcome_quality

required

Any of:

number

number

null

null

reasoning_chain

required

Any of:

string

string

null

null

reversed

required

boolean

reversible

required

boolean

signature

Any of:

string

string

null

null

signature_algorithm

Any of:

string

string

null

null

signed_at_sig

Any of:

string

string format: date-time

null

null

signer_certificate_id

Any of:

string

string

null

null

signer_fingerprint

Any of:

string

string

null

null

status

required

string

tenant_id

required

string

422

Validation Error

object

detail

Array<object>

object

ctx

object

input

loc

required

Array

msg

required

string

type

required

string