Retrieve a decision

Use this operation to explain an outcome, observe approval state, or reconcile what happened after authorization.

GET/workspaces/{workspace_slug}/decisions/{decision_id}

Parameters

Parameter	Location	Required	Description
workspace_slug	Path	Yes	Workspace that owns the decision.
decision_id	Path	Yes	Stable identifier returned by evaluation.

Request

curl "$ACTERA_BASE_URL/workspaces/$ACTERA_WORKSPACE_SLUG/decisions/$DECISION_ID" \
  "${ACTERA_AUTH_HEADERS[@]}"

Response excerpt

{
  "id": "dec_7f26",
  "agent_id": "refund-agent",
  "action_type": "refund.create",
  "effect": "REQUIRE_APPROVAL",
  "status": "APPROVED",
  "policy_bundle_version": "12",
  "matched_policy_ids": ["pol_refund_repeat"],
  "matched_rules": ["repeat-refund-review"],
  "explanation": "Repeat refunds require review",
  "events": [
    { "event_type": "DECISION_RECEIVED", "to_state": "RECEIVED" },
    { "event_type": "DECISION_APPROVED", "from_state": "PENDING_APPROVAL", "to_state": "APPROVED", "actor_id": "reviewer-42" }
  ],
  "subsequent_activities": []
}

The actual response also includes evaluation context, applicable policies, rule evaluations, approval requirements, reservations, activity, and managed execution evidence when present.

Read events in order. APPROVED proves authorization, not completed external execution. An unknown identifier returns 404; a decision in another workspace is not disclosed. This read is safe to retry. See Inspect a decision for an evidence checklist.