Errors

Responses use JSON-RPC error objects: { code, message, data? }. Prefer error.data.next_actions when present.

Code	Message	Fix
-32700	Parse error	Send valid JSON
-32601	Method not found	Check Agent Card / API Reference skill names
-32602	Invalid params	Supply required fields (e.g. `idempotency_key`)
-32000	Unauthorized / app error	Bearer key or read `data`
-32001	Not found	Wrong id or wrong API key
-32003	No valid sending number	Trust Setup + phone numbers
-32005	Launch preflight failed	Resolve preflight blockers
consent_required	Not opted in	`contacts.optIn` / import provenance
payment_hold	Payment hold	Billing portal / credits
partner_suspended	Partner suspended	Contact BizBionic support
idempotency_key_required	Missing idempotency	Required on `partner.send`
credits_insufficient	Low credits	Top up / `partner.grantCredits`

Machine-readable: errors.json.

Next steps