Skip to content
UltimateTeam.ai Docs

Full decision provenance

GET
/api/v1/decisions/{decision_id}/detail
curl --request GET \
  --url https://api.ultimateteam.ai/api/v1/decisions/example/detail \
  --header 'X-API-Key: <X-API-Key>'

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

Section titled “Authorizations”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
decision_id
required
Decision Id

The decision UUID to retrieve

string

The decision UUID to retrieve

Responses

Section titled “ Responses ”

200

Section titled “200”

Successful Response

Media typeapplication/json
DecisionDetailResponse

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
Action Type
string
actual_outcome
required
Any of:
object
key
additional properties
any
agent_role
required
Agent Role
string
autonomy_level
required
Autonomy Level
integer
calibration_evidence
Any of:
object
key
additional properties
any
confidence_score
required
Any of:
number
created_at
required
Created At
string format: date-time
data_sources
required
Data Sources
Array<object>
object
key
additional properties
any
decided_at
required
Any of:
string format: date-time
description
required
Description
string
expected_outcome
required
Any of:
object
key
additional properties
any
id
required
Id
string
moa_consensus
Any of:
object
key
additional properties
any
outcome_measured_at
required
Any of:
string format: date-time
outcome_quality
required
Any of:
number
reasoning_chain
required
Any of:
string
reversed
required
Reversed
boolean
reversible
required
Reversible
boolean
signal_classifications
Any of:
object
key
additional properties
any
signature
Any of:
string
signature_algorithm
Any of:
string
signed_at_sig
Any of:
string format: date-time
signer_certificate_id
Any of:
string
signer_fingerprint
Any of:
string
status
required
Status
string
tenant_id
required
Tenant Id
string
Examplegenerated
{
  "action_type": "example",
  "actual_outcome": {},
  "agent_role": "example",
  "autonomy_level": 1,
  "calibration_evidence": {},
  "confidence_score": 1,
  "created_at": "2026-04-15T12:00:00Z",
  "data_sources": [
    {}
  ],
  "decided_at": "2026-04-15T12:00:00Z",
  "description": "example",
  "expected_outcome": {},
  "id": "example",
  "moa_consensus": {},
  "outcome_measured_at": "2026-04-15T12:00:00Z",
  "outcome_quality": 1,
  "reasoning_chain": "example",
  "reversed": true,
  "reversible": true,
  "signal_classifications": {},
  "signature": "example",
  "signature_algorithm": "example",
  "signed_at_sig": "2026-04-15T12:00:00Z",
  "signer_certificate_id": "example",
  "signer_fingerprint": "example",
  "status": "example",
  "tenant_id": "example"
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}