Skip to main content
@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.

​
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.

​
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.

​
September 20, 2026

​
Operations

The SDK added operations.list, get, listTransitions, wait, and cancel. See Events and operations.

​
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.

​
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. 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. The browser widget.start and widget.status helpers were also removed.