Update to Bird

{
  "description": "Use when operating Bird through the bird CLI to preview or send messages, inspect or manage API resources, register or inspect Inbox Insights seed tests, or onboard an account; excludes client development.",
  "included_files": [
    {
      "relative_path": "references/amb.md",
      "size_in_bytes": 2985
    },
    {
      "relative_path": "references/api-keys.md",
      "size_in_bytes": 7550
    },
    {
      "relative_path": "references/authenticate.md",
      "size_in_bytes": 2728
    },
    {
      "relative_path": "references/competitive-access.md",
      "size_in_bytes": 1041
    },
    {
      "relative_path": "references/competitive-brand.md",
      "size_in_bytes": 556
    },
    {
      "relative_path": "references/competitive-campaign.md",
      "size_in_bytes": 579
    },
    {
      "relative_path": "references/competitive-campaigns.md",
      "size_in_bytes": 1238
    },
    {
      "relative_path": "references/competitive-create.md",
      "size_in_bytes": 991
    },
    {
      "relative_path": "references/competitive-delete.md",
      "size_in_bytes": 923
    },
    {
      "relative_path": "references/competitive-notable.md",
      "size_in_bytes": 488
    },
    {
      "relative_path": "references/competitive-search.md",
      "size_in_bytes": 479
    },
    {
      "relative_path": "references/competitive-send-time.md",
      "size_in_bytes": 594
    },
    {
      "relative_path": "references/competitive-volume-series.md",
      "size_in_bytes": 818
    },
    {
      "relative_path": "references/competitive-watchlist.md",
      "size_in_bytes": 577
    },
    {
      "relative_path": "references/competitive.md",
      "size_in_bytes": 1072
    },
    {
      "relative_path": "references/compliance-identities.md",
      "size_in_bytes": 2963
    },
    {
      "relative_path": "references/contacts.md",
      "size_in_bytes": 3367
    },
    {
      "relative_path": "references/docs.md",
      "size_in_bytes": 2589
    },
    {
      "relative_path": "references/domains.md",
      "size_in_bytes": 5112
    },
    {
      "relative_path": "references/email-broadcasts.md",
      "size_in_bytes": 2670
    },
    {
      "relative_path": "references/email-templates.md",
      "size_in_bytes": 9089
    },
    {
      "relative_path": "references/email.md",
      "size_in_bytes": 7638
    },
    {
      "relative_path": "references/esim-cancel-renewal.md",
      "size_in_bytes": 505
    },
    {
      "relative_path": "references/esim-credentials.md",
      "size_in_bytes": 654
    },
    {
      "relative_path": "references/esim-delete-package.md",
      "size_in_bytes": 593
    },
    {
      "relative_path": "references/esim-delivery.md",
      "size_in_bytes": 752
    },
    {
      "relative_path": "references/esim-purchase.md",
      "size_in_bytes": 1648
    },
    {
      "relative_path": "references/esim-release.md",
      "size_in_bytes": 568
    },
    {
      "relative_path": "references/esim-renewal.md",
      "size_in_bytes": 841
    },
    {
      "relative_path": "references/esim-resume.md",
      "size_in_bytes": 472
    },
    {
      "relative_path": "references/esim-suspend.md",
      "size_in_bytes": 471
    },
    {
      "relative_path": "references/esim.md",
      "size_in_bytes": 519
    },
    {
      "relative_path": "references/inbound.md",
      "size_in_bytes": 4776
    },
    {
      "relative_path": "references/inbox-insights-access.md",
      "size_in_bytes": 1069
    },
    {
      "relative_path": "references/inbox-insights-authentication.md",
      "size_in_bytes": 868
    },
    {
      "relative_path": "references/inbox-insights-benchmark.md",
      "size_in_bytes": 799
    },
    {
      "relative_path": "references/inbox-insights-blocklists.md",
      "size_in_bytes": 618
    },
    {
      "relative_path": "references/inbox-insights-complaints.md",
      "size_in_bytes": 711
    },
    {
      "relative_path": "references/inbox-insights-domains.md",
      "size_in_bytes": 872
    },
    {
      "relative_path": "references/inbox-insights-monitoring-setup.md",
      "size_in_bytes": 776
    },
    {
      "relative_path": "references/inbox-insights-monitoring-update.md",
      "size_in_bytes": 1057
    },
    {
      "relative_path": "references/inbox-insights-placement.md",
      "size_in_bytes": 1145
    },
    {
      "relative_path": "references/inbox-insights-seed-configuration.md",
      "size_in_bytes": 693
    },
    {
      "relative_path": "references/inbox-insights-seed-create.md",
      "size_in_bytes": 1942
    },
    {
      "relative_path": "references/inbox-insights-seed-list.md",
      "size_in_bytes": 764
    },
    {
      "relative_path": "references/inbox-insights-spam-traps.md",
      "size_in_bytes": 663
    },
    {
      "relative_path": "references/inbox-insights.md",
      "size_in_bytes": 1039
    },
    {
      "relative_path": "references/ip-pools.md",
      "size_in_bytes": 4495
    },
    {
      "relative_path": "references/lookup.md",
      "size_in_bytes": 6864
    },
    {
      "relative_path": "references/onboarding.md",
      "size_in_bytes": 1737
    },
    {
      "relative_path": "references/preferences.md",
      "size_in_bytes": 2658
    },
    {
      "relative_path": "references/realtime.md",
      "size_in_bytes": 4957
    },
    {
      "relative_path": "references/received-mail-stats.md",
      "size_in_bytes": 2242
    },
    {
      "relative_path": "references/sms-senders.md",
      "size_in_bytes": 4805
    },
    {
      "relative_path": "references/sms.md",
      "size_in_bytes": 3759
    },
    {
      "relative_path": "references/support.md",
      "size_in_bytes": 3718
    },
    {
      "relative_path": "references/tfn-verifications.md",
      "size_in_bytes": 5077
    },
    {
      "relative_path": "references/trust.md",
      "size_in_bytes": 5641
    },
    {
      "relative_path": "references/unsubscribe-page.md",
      "size_in_bytes": 2020
    },
    {
      "relative_path": "references/verify.md",
      "size_in_bytes": 5703
    },
    {
      "relative_path": "references/voice.md",
      "size_in_bytes": 18660
    },
    {
      "relative_path": "references/webhooks.md",
      "size_in_bytes": 12687
    },
    {
      "relative_path": "references/whatsapp-agents.md",
      "size_in_bytes": 4499
    },
    {
      "relative_path": "references/whatsapp-groups.md",
      "size_in_bytes": 7661
    },
    {
      "relative_path": "references/whatsapp-keyword-rules.md",
      "size_in_bytes": 3534
    },
    {
      "relative_path": "references/whatsapp-messages.md",
      "size_in_bytes": 5879
    },
    {
      "relative_path": "references/whatsapp-numbers-and-accounts.md",
      "size_in_bytes": 6257
    },
    {
      "relative_path": "references/whatsapp-preview.md",
      "size_in_bytes": 1096
    },
    {
      "relative_path": "references/whatsapp-receipts-and-reactions.md",
      "size_in_bytes": 2660
    },
    {
      "relative_path": "references/whatsapp-stats.md",
      "size_in_bytes": 2412
    },
    {
      "relative_path": "references/whatsapp-suppressions.md",
      "size_in_bytes": 3046
    },
    {
      "relative_path": "references/whatsapp-templates.md",
      "size_in_bytes": 12754
    },
    {
      "relative_path": "references/whatsapp.md",
      "size_in_bytes": 1233
    }
  ],
  "name": "bird-cli",
  "skill_md_contents": "---\nname: bird-cli\ndescription: Use when operating Bird through the bird CLI to preview or send messages, inspect or manage API resources, register or inspect Inbox Insights seed tests, or onboard an account; excludes client development.\n---\n\n# Bird CLI\n\n`bird` is a single binary for the Bird API and local tools such as WhatsApp message previews. Account operations need credentials; local previews do not.\n\nThis skill requires the `bird` CLI. If `command -v bird` finds nothing, install it with `brew install messagebird/tap/bird`, or follow the [CLI installation instructions](https://bird.com/docs/cli#install) for other platforms.\n\n## The path\n\n**Step 0 — Authenticate for account operations.** For a WhatsApp preview, go directly to [Preview](references/whatsapp.md#preview); for public documentation questions, use [docs](references/docs.md). For account operations, confirm credentials first: [authenticate](references/authenticate.md). It is a no-op when `bird auth status` already reports `valid: true`. No account yet? Create one through [onboarding](references/onboarding.md); it ends by storing the same credential a login would.\n\n**Step 1 — Run the operation the user asked for:**\n\n- Send or inspect email messages (`bird email`, including `send-batch`) → [email](references/email.md)\n- Author reusable email templates, submit a draft, or roll one back (`bird email templates`) → [email-templates](references/email-templates.md)\n- Prepare, send, or inspect a marketing broadcast (`bird email broadcasts`) → [email-broadcasts](references/email-broadcasts.md)\n- Send or inspect SMS messages, or browse SMS templates (`bird sms`) → [sms](references/sms.md)\n- Draft the carrier verification a US toll-free number needs before it can send, read what the carrier asks for, or see why one was declined (`bird sms tfn verifications`) → [tfn-verifications](references/tfn-verifications.md)\n- Claim an alphanumeric SMS sender, find out what a country requires of it, or register it for a country (`bird sms senders`) → [sms-senders](references/sms-senders.md)\n- Reply to Apple Messages conversations or manage businesses and statistics (`bird amb`) → [Apple Messages](references/amb.md)\n- Preview a WhatsApp message (`bird whatsapp preview`) → [Preview](references/whatsapp.md#preview) (local — skips Step 0)\n- Send or inspect WhatsApp messages, receipts, reactions, senders, suppressions, keyword rules or statistics (`bird whatsapp`) → [WhatsApp operations](references/whatsapp.md)\n- Browse WhatsApp templates, their versions, and each version's per-language content (`bird whatsapp templates`) → [whatsapp-templates](references/whatsapp-templates.md)\n- Create and administer WhatsApp groups, hand out or rotate an invite link, decide join requests, pin messages, or remove a participant (`bird whatsapp groups`) → [whatsapp-groups](references/whatsapp-groups.md)\n- Set up the WhatsApp Business Agent on a number — onboard it, give it FAQs, websites, files and skills, test it, then turn it on (`bird whatsapp agents`) → [whatsapp-agents](references/whatsapp-agents.md)\n- Inspect voice calls, find out why one was refused, configure a SIP trunk or an inbound number, register or verify an outbound caller ID, enable or disable calling to a country, or place a test call (`bird voice`) → [voice](references/voice.md)\n- Buy an eSIM, add data, deliver installation details, or manage recurring packages (`bird esim`) → [eSIM](references/esim.md)\n- Provision Realtime apps and rotate the keys their clients connect with (`bird realtime`) → [realtime](references/realtime.md)\n- Verify a recipient with a one-time passcode — send a code, then check what they submit (`bird verify verifications`) → [verify](references/verify.md)\n- Find out about a recipient before you use it — grade an email address, or identify a phone number and its network (`bird lookup`) → [lookup](references/lookup.md)\n- Manage contacts, audiences, and contact properties (`bird contacts`, `bird audiences`, `bird contact-properties`) → [contacts](references/contacts.md)\n- Record and look up messaging consent grants and opt-outs (`bird preferences`) → [preferences](references/preferences.md)\n- Manage sending domains (`bird email domains`), or find a verified `from` to send from → [domains](references/domains.md)\n- Count how much mail the workspace received, by period, day or hour (`bird email stats inbound`) → [received-mail-stats](references/received-mail-stats.md)\n- Inspect owned-domain placement and authentication, or configure, register and read seed tests (`bird email inbox-insights`) → [inbox-insights](references/inbox-insights.md)\n- Inspect competitive email intelligence (`bird email competitive`) → [competitive](references/competitive.md)\n- Style the hosted page a marketing recipient lands on when they unsubscribe (`bird email unsubscribe-page`) → [unsubscribe-page](references/unsubscribe-page.md)\n- Manage dedicated IPs (`bird email dedicated-ips`) and IP pools (`bird email ip-pools`) (sending reputation) → [ip-pools](references/ip-pools.md)\n- Receive email at inbound forward addresses (`bird email inbound-addresses`), or read the mail received there (`bird email inbound-messages`) → [inbound](references/inbound.md)\n- Manage outbound webhook endpoints, or send events to Zapier, Make, n8n or your own endpoint and prove one arrives → [webhooks](references/webhooks.md)\n- Issue or rotate a workspace API key (`bird api-keys create`, `bird api-keys rotate`) → [api-keys](references/api-keys.md) (needs a login carrying `api_keys:write`; an API key cannot run it)\n- Find out why acquiring a number or registering a sender was refused for a reason about the organization rather than the country, and settle the requirement behind it (`bird trust`) → [trust](references/trust.md)\n- Find the business a 10DLC brand is registered for, so `brands create` can name it (`bird compliance identities list`) → [compliance-identities](references/compliance-identities.md)\n- Register a 10DLC brand for US A2P traffic, or file a submission against one (`bird sms 10dlc brands create`, `bird sms 10dlc brands submissions create`) → sibling operations; node not yet authored, `--help` on each carries the field list\n- Open a support ticket, reply to it, or wait for a support agent reply → [support](references/support.md)\n- Answer a how-to or reference question about Bird from the documentation → [docs](references/docs.md) (public — skips Step 0)\n- Inspect resolved CLI configuration → `bird config show` (sibling operation; node not yet authored)\n\nPick the operation that matches the request. Complete Step 0 only for operations that require an account.\n\n## Conventions every command shares\n\nThese hold across operations, so the nodes rely on them instead of repeating them:\n\n- **Output is JSON by default** (`--format json`). Single-record commands (`get`, `status`, `show`) also take `--format text` for a human-readable card. List commands ignore `--format text` and always emit JSON, so a script can pipe them through `jq` without a per-command branch.\n- **Exit codes carry the failure category** so a caller can branch without parsing prose: `2` invalid usage or input, `3` not found, `4` auth or permission denied, `5` conflict, `6` transient (rate limit or server error, retry after `retry_after`), `7` a check ran and found a problem (`check_failed`), `1` anything else. Errors print to stderr; data to stdout.\n- **Every error explains itself.** The envelope always carries a readable `message`, and most errors carry a stable `code`. An error from the Bird API also carries a `doc_url` to that code's page, which says what went wrong and what to do; every code is listed at https://bird.com/docs/api/errors. Read `details`, when present, for each failing field.\n- **Transient failures are retried for you.** A rate limit, a 5xx, or a network blip is retried twice with backoff before the command fails, so an error marked `retryable` has already been through that — re-running it immediately rarely helps. `--max-retries 0` turns it off when you drive your own retry loop.\n- **Retry progress goes to stderr.** The CLI reports the retry reason and remaining wait there; JSON result data stays on stdout.\n- **The login sets the region.** The token from `bird auth login` is bound to one workspace and its region, which picks the API host; override with `--base-url`/`BIRD_API_URL`. Details and the state check live in [authenticate](references/authenticate.md).\n"
}