Errors & Fixes

This page covers common causes of WARN / BLOCK and how to fix them.

Unknown action_kind

**Symptom**

BLOCK: Unknown action_kind ...

**Fix**

Use one of the supported public action_kind values:

- /docs/action-reference

Use the exact string (case-sensitive).

Copy/paste invalid example

json

{
  "action_kind": "money.refnd",
  "action_type": "refund",
  "ai_output": {"refund_amount_usd": 10},
  "context": {
    "workflow": "refund",
    "workflowName": "Refund",
    "system_instructions": "Only refund when authorized.",
    "user_input": "Refund $10.",
    "actor_user_id": "user_456",
    "account_id": "acct_123",
    "request_id": "req_001",
    "idempotency_key": "refund_req_001"
  }
}

Invalid action_type for action_kind

**Symptom**

BLOCK: Unknown action_type for action_kind ...

**Fix**

Use an allowed action_type for that action_kind:

- /docs/action-kinds/<action_kind>

Copy/paste invalid example

json

{
  "action_kind": "money.refund",
  "action_type": "charge",
  "ai_output": {"refund_amount_usd": 10},
  "context": {
    "workflow": "refund",
    "workflowName": "Refund",
    "system_instructions": "Only refund when authorized.",
    "user_input": "Refund $10.",
    "actor_user_id": "user_456",
    "account_id": "acct_123",
    "request_id": "req_001",
    "idempotency_key": "refund_req_001"
  }
}

Missing required context

**Symptom**

BLOCK: Missing required context (...)

**Fix**

Provide the missing fields in context.
Ensure values are not empty strings.
For most integrations, the core required set is:

- workflow, workflowName, system_instructions, user_input, actor_user_id, account_id, request_id, idempotency_key

Copy/paste invalid example

json

{
  "action_kind": "messaging.send",
  "action_type": "send",
  "ai_output": {
    "to": "user_789",
    "channel": "email",
    "subject": "Receipt",
    "body": "Thanks for your purchase."
  },
  "context": {
    "account_id": "acct_123",
    "actor_user_id": "user_456"
  }
}

Schema mismatch

**Symptom**

BLOCK (or an error) when fields are the wrong type.

**Fix**

Send strict JSON using the Schema Reference:

- /docs/schema-reference

ai_output must be a JSON object.
action_kind and action_type must be strings.

Copy/paste invalid example

json

{
  "action_kind": "messaging.send",
  "action_type": "send",
  "ai_output": "send an email",
  "context": {
    "workflow": "send_receipt",
    "workflowName": "Send Receipt",
    "system_instructions": "Send only to the intended recipient.",
    "user_input": "Send a receipt email.",

    "actor_user_id": "user_456",
    "account_id": "acct_123",
    "request_id": "req_001",
    "idempotency_key": "send_receipt_req_001"
  }
}

What to do on WARN

Do not execute.
Persist decision_id.
Route to approvals and wait for approval.

What to do on BLOCK

Do not execute.
Persist decision_id.
Fix the payload and retry.

Legal & Responsibility Notice

Summary

Informational only

Provided for general guidance. Not legal, compliance, security, or professional advice.

You control implementation

You are responsible for policies, prompts, integrations, workflows, and regulatory requirements.

Liability limitation

To the maximum extent permitted by law, the company disclaims liability for losses arising from use of this documentation or implementations based on it.