- SMS segment docs: the UCS2 limit is 70 UTF-16 code units, not 70 ch…

…aracters, so 35 non-BMP emoji fill one segment.

- Add the `workspace` resource: `get()` returns the workspace the cre…

…dential is scoped to, including its id, name, owning organization's id, and notification and logo settings.

- A `404` from checking or advancing a verification now says that no …

…verification matched the recipient: either none exists for the exact recipient given, or the most recent one is already resolved as verified, expired, or out of attempts. It also says when to create another — create one when the recipient has no verification, or the last one expired or ran out of attempts, and not when the recipient already passed. The error code is unchanged, so match it exactly as before; a `404` is not evidence the recipient failed to verify, so treat your own record of an earlier `success: true` as the outcome.

- A WhatsApp message carrying contact cards a contact shared now read…

…s them back on `contact_cards`, where it previously reported `unsupported` with type `contacts`.

- `undelivered` now documents as a final status, `validity_period` as bounding the carrier's delivery attempts rather than ours, and `scheduled` and `canceled` as reserved for send-later scheduling. `category` no longer describes per-country compliance rules that are not implemented.

- Sending a WhatsApp template: the `parameters` field now documents w…

…hich button types take no value, so no component is sent for them.

- Example values on `date`, `date-time` and numeric fields now match …

…the examples the API declares (`2026-05-01` for a `date` field, `0.0` for a nullable number).

- Add the `preferences` resource — list, get, create, and delete stat…

…ed messaging preferences (consent grants and opt-outs) across email, SMS, and WhatsApp — plus `contacts.preferences.list` for the rows keyed to a contact's own handles, and typed webhook events for `preference.granted`, `preference.revoked`, `preference.deleted`, and `whatsapp_suppression.created`.

- `refresh_cursor` fetches the items that sort before a response's fi…

…rst row in the current sort order. Those are the items added since the response only when new items sort first, so a list sorted another way is refreshed by re-fetching it.

- `Number.kind` documentation now distinguishes workspace-owned subsc…

…riptions from Bird-managed shared numbers.

- Voice call records carry a `tags` array, and the voice call list ta…

…kes a repeatable `tag` filter (`name` or `name:value`). On the CLI that is `bird voice list --tag campaign:spring --tag queue`.