> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymorfa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Version notes

> Changes in @polymorfa/sdk prereleases that need action when you upgrade, newest first.

`@polymorfa/sdk` is a development prerelease. A prerelease can change a method
or a response shape. This page lists the changes that need action when you
upgrade, newest first. Each version is named `0.1.0-dev.<timestamp>`, so you can
compare yours with the versions below.

Check the installed version with `npm ls @polymorfa/sdk`, or read the
`SDK_VERSION` export.

## October 1, 2026

### Flow drafts return the draft in `response.data`

From `0.1.0-dev.20261001124422`, `flows.list` and `flows.retrieve` return the
drafts directly in `response.data`.

`0.1.0-dev.20260926213449` through `0.1.0-dev.20260927174827` returned them in
`response.data.data`. Replace `response.data.data` with `response.data` when you
upgrade. See [Flows](/sdks/typescript/flows).

### Campaign send windows

From `0.1.0-dev.20261001124422`, `messaging.campaigns.create`,
`platform.campaigns.create`, and `platform.campaigns.update` accept
`sendWindow`, and campaign records include it. The SDK exports
`CampaignSendWindowRequest` and `CampaignSendWindow`. See
[Campaigns](/sdks/typescript/campaigns#create-a-campaign).

## September 26, 2026

### Flow draft reads

`0.1.0-dev.20260926213449` added `flows.list` and `flows.retrieve` on project
clients.

## September 22, 2026

### `whatsapp_ids` replaces `whatsapp_id`

API version `2026-09-22` returns WhatsApp message references in `whatsapp_ids`,
under `linked_devices`, `official_api`, or both. SDK message receipts and
webhook types include it. The singular `whatsapp_id` field is deprecated and
remains only while older API versions are supported. Read `whatsapp_ids` in new
code. See [Message IDs](/sdks/typescript/messages#message-ids).

## September 20, 2026

### Operations

The SDK added `operations.list`, `get`, `listTransitions`, `wait`, and `cancel`.
See [Events and operations](/sdks/typescript/events#wait-for-an-operation).

## September 2026

### Number tier changes use a quote

`sessions.setTierOverride(sessionId, { tierOverride })` was replaced by a quote
and a confirmation. Call `sessions.quoteTierChange`, show the quote, then pass
its ID as `setTierOverride(sessionId, { quoteId })`. Read the result with
`sessions.retrieveTierChange`. See
[Change a Number's tier](/sdks/typescript/numbers#change-a-numbers-tier).

### Balance warning settings removed

`billing.updateReminderSettings` was removed, and billing responses no longer
include `lowBalanceThresholdCents` or `reminderChannels`. Configure balance
warnings in the Console under **My Notifications**.

Credit amounts in balances, usage, and BanSafe claims can have up to six decimal
places, including fields whose names end in `Cents`. Do not parse them as
integers.

### QuickLink replaces direct Number creation

`sessions.create` and `sessions.createTesting` were removed. Create Numbers
with `messaging.quickLinks.create`. Number settings changes use
`sessions.update` with a `revision` and `configuration.set` or
`configuration.reset`. See
[Connect and manage Numbers](/sdks/typescript/numbers).

The browser `widget.start` and `widget.status` helpers were also removed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.