{
  "generated_at": "2026-07-16T02:58:51.618Z",
  "audience": "public",
  "count": 19,
  "generated_note": "Customer-facing only. No internal skill names or infrastructure jargon.",
  "errors": [
    {
      "code": -32700,
      "message": "Parse error",
      "fix": "Send valid JSON in the request body.",
      "http_hint": 400
    },
    {
      "code": -32600,
      "message": "Invalid Request",
      "fix": "Include jsonrpc, method, and a valid id per JSON-RPC 2.0.",
      "http_hint": 400
    },
    {
      "code": -32601,
      "message": "Method not found",
      "fix": "Check skill names via GET /.well-known/agent.json or the public API Reference.",
      "related_skills": [
        "agent.discover",
        "agent.capabilities"
      ]
    },
    {
      "code": -32602,
      "message": "Invalid params",
      "fix": "Supply required fields for the skill (see API Reference)."
    },
    {
      "code": -32000,
      "message": "Unauthorized / application error",
      "fix": "For HTTP 401: send Authorization: Bearer bb_…. Read error.data.next_actions when present.",
      "http_hint": 401,
      "related_skills": [
        "agent.provision",
        "partner.register"
      ]
    },
    {
      "code": -32001,
      "message": "Not found",
      "fix": "Resource missing for this account. Verify the id and that you are using the correct API key."
    },
    {
      "code": -32002,
      "message": "Unprocessable / no eligible audience or content",
      "fix": "Check consent, campaign content, and preflight.",
      "related_skills": [
        "contacts.optIn",
        "campaigns.preflight"
      ]
    },
    {
      "code": -32003,
      "message": "No valid sending number",
      "fix": "Complete Trust Setup and ensure a default sender number.",
      "related_skills": [
        "phone-numbers.ensureDefault",
        "compliance.setupStatus"
      ]
    },
    {
      "code": -32005,
      "message": "Launch preflight failed",
      "fix": "Run campaigns.preflight and resolve blockers.",
      "related_skills": [
        "campaigns.preflight",
        "billing.balance"
      ]
    },
    {
      "code": "consent_required",
      "message": "Contact is not opted in",
      "fix": "Use contacts.optIn or import with consent provenance.",
      "related_skills": [
        "contacts.optIn",
        "contacts.import"
      ]
    },
    {
      "code": "payment_hold",
      "message": "Account on payment hold",
      "fix": "Resolve billing in the portal or add credits.",
      "related_skills": [
        "billing.balance",
        "billing.portal"
      ]
    },
    {
      "code": "partner_suspended",
      "message": "Partner organization suspended",
      "fix": "Contact BizBionic support. Partners cannot self-unsuspend.",
      "related_skills": [
        "partner.setupStatus"
      ]
    },
    {
      "code": "partner_child_paused",
      "message": "End-customer is paused",
      "fix": "Call partner.setChildPaused with paused: false after review.",
      "related_skills": [
        "partner.setChildPaused"
      ]
    },
    {
      "code": "idempotency_key_required",
      "message": "idempotency_key is required for partner.send",
      "fix": "Pass a stable unique idempotency_key per logical send.",
      "related_skills": [
        "partner.send"
      ]
    },
    {
      "code": "external_ref_required",
      "message": "external_ref required",
      "fix": "Identify the end-customer with external_ref only.",
      "related_skills": [
        "partner.send"
      ]
    },
    {
      "code": "credits_insufficient",
      "message": "Insufficient credits",
      "fix": "Top up credits; check billing.balance.",
      "related_skills": [
        "billing.balance",
        "partner.grantCredits"
      ]
    },
    {
      "code": "quiet_hours",
      "message": "Quiet hours block send",
      "fix": "Schedule outside quiet hours or adjust account quiet-hour settings.",
      "related_skills": [
        "campaigns.preflight"
      ]
    },
    {
      "code": "import_batch_limit",
      "message": "Maximum 500 contacts per import batch",
      "fix": "Chunk contacts.import to ≤500 rows.",
      "related_skills": [
        "contacts.import"
      ]
    },
    {
      "code": "invalid_permissions",
      "message": "API key permissions insufficient",
      "fix": "Use a key with the required scope, or create a new key.",
      "related_skills": [
        "agent.createKey"
      ]
    }
  ]
}