Quick Start

This page shows a minimal, copy/paste-safe integration.

Where to call ASG

Call ASG after you have final AI output, and immediately before the side effect.

Example `action_kind`

This example uses:

• action_kind: money.refund
• action_type: refund (enforced)

Request contract

The authoritative request/response schema for POST /api/validate is rendered from the shared Zod schemas here:

/docs/schema-reference

context is optional at the schema level, but many action_kind pages will BLOCK or WARN if required context evidence is missing (managed-policy requiredContext).

Minimal request (copy/paste)

{
  "action_kind": "money.refund",
  "action_type": "refund",
  "ai_output": {},
  "context": {
    "workflow": "refund_workflow_v1",
    "workflowName": "Refund Workflow",
    "system_instructions": "Execute refunds only after validation and policy checks.",
    "user_input": "Customer requested a refund for invoice inv_789.",
    "actor_user_id": "user_456",
    "account_id": "acct_123",
    "request_id": "req_001",
    "idempotency_key": "refund_req_001",

    "session_user_id": "user_456",
    "invoice_id": "inv_789",
    "transaction_id": "txn_123",
    "case_id": "case_001",

PASS response

{
  "status": "PASS",
  "decision_id": "dec_...",
  "risk_score": 0,
  "reason": "..."
}

BLOCK example (wrong action_type)

If you send an invalid action_type, ASG blocks with an explicit reason.

Request:

{
  "action_kind": "money.refund",
  "action_type": "refund_now",
  "ai_output": {},
  "context": {
    "account_id": "acct_123"
  }
}

Response (exact reason format):

{
  "status": "BLOCK",
  "decision_id": "dec_...",
  "risk_score": 95,
  "reason": "BLOCK: Unknown action_type for action_kind money.refund. Supported action_type values: refund."
}

What to do next

• Use **Action Reference** to pick the right action_kind and copy the allowed action_type:

- /docs/action-reference

• If you get BLOCK, go to Troubleshooting:

- /docs/troubleshooting/block-reasons

• If you cannot complete approval, go to:

- /docs/troubleshooting/approval-failures