@linqapp/sdk 0.79.0 → 0.81.0

package/src/client.ts

@@ -45,6 +45,12 @@ import {
   BlockedHandleUnblockParams,
   BlockedHandles,
 } from './resources/blocked-handles';
+import {
+  CallVoice,
+  CallVoiceListParams,
+  CallVoiceListResponse,
+  CallVoiceRecord,
+} from './resources/call-voice';
 import {
   Capability,
   CapabilityCheckIMessageParams,
@@ -99,6 +105,15 @@ import {
   ReputationUnhealthyChat,
 } from './resources/phone-numbers';
 import { PhonenumberListResponse, Phonenumbers } from './resources/phonenumbers';
+import {
+  SipProfile,
+  SipProfileAssignParams,
+  SipProfileAssignResponse,
+  SipProfileCreateParams,
+  SipProfileListResponse,
+  SipProfileUpdateParams,
+  SipProfiles,
+} from './resources/sip-profiles';
 import { WebhookEventListResponse, WebhookEventType, WebhookEvents } from './resources/webhook-events';
 import {
   WebhookSubscription,
@@ -115,6 +130,13 @@ import {
   APITokenExpiredWebhookEvent,
   APITokenExpiryScheduledWebhookEvent,
   APITokenRenamedWebhookEvent,
+  CallVoiceAnsweredWebhookEvent,
+  CallVoiceDeclinedWebhookEvent,
+  CallVoiceEndedWebhookEvent,
+  CallVoiceFailedWebhookEvent,
+  CallVoiceInitiatedWebhookEvent,
+  CallVoiceNoAnswerWebhookEvent,
+  CallVoiceRingingWebhookEvent,
   ChatBackgroundUpdateFailedWebhookEvent,
   ChatBackgroundUpdatedWebhookEvent,
   ChatCreatedWebhookEvent,
@@ -153,6 +175,7 @@ import {
   PaymentSucceededWebhookEvent,
   PhoneNumberAssignedWebhookEvent,
   PhoneNumberForwardingUpdatedWebhookEvent,
+  PhoneNumberLineTypeUpdatedWebhookEvent,
   PhoneNumberReleasedWebhookEvent,
   PhoneNumberStatusUpdatedWebhookEvent,
   PollDeliveredWebhookEvent,
@@ -1272,6 +1295,19 @@ export class LinqAPIV3 {
    * numbers are eligible, you get `409` (no `from` number was ever chosen, so there's no
    * specific number to blame with a `403`).
    *
+   * **Published vs unpublished.** A *published* number is available for your account to use.
+   * Only published numbers appear in `GET /v3/phone_numbers`.
+   *
+   * Unpublished numbers allow `GET` requests. `POST`, `PUT`, `PATCH`, and `DELETE` requests that
+   * change a chat return `403` with error code `2033` (`Phone number is unpublished`).
+   *
+   * A number's existing data is preserved when its status changes to unpublished. Unpublished
+   * status alone does not block reads, blocked-handle management, or deletion
+   * of your data. Existing authorization, retention, and endpoint rules still apply.
+   *
+   * Webhook events are suppressed for affected numbers when their publication status is known to
+   * be unpublished.
+   *
    */
   phonenumbers: API.Phonenumbers = new API.Phonenumbers(this);
   /**
@@ -1292,6 +1328,19 @@ export class LinqAPIV3 {
    * numbers are eligible, you get `409` (no `from` number was ever chosen, so there's no
    * specific number to blame with a `403`).
    *
+   * **Published vs unpublished.** A *published* number is available for your account to use.
+   * Only published numbers appear in `GET /v3/phone_numbers`.
+   *
+   * Unpublished numbers allow `GET` requests. `POST`, `PUT`, `PATCH`, and `DELETE` requests that
+   * change a chat return `403` with error code `2033` (`Phone number is unpublished`).
+   *
+   * A number's existing data is preserved when its status changes to unpublished. Unpublished
+   * status alone does not block reads, blocked-handle management, or deletion
+   * of your data. Existing authorization, retention, and endpoint rules still apply.
+   *
+   * Webhook events are suppressed for affected numbers when their publication status is known to
+   * be unpublished.
+   *
    */
   phoneNumbers: API.PhoneNumbers = new API.PhoneNumbers(this);
   /**
@@ -1312,6 +1361,19 @@ export class LinqAPIV3 {
    * numbers are eligible, you get `409` (no `from` number was ever chosen, so there's no
    * specific number to blame with a `403`).
    *
+   * **Published vs unpublished.** A *published* number is available for your account to use.
+   * Only published numbers appear in `GET /v3/phone_numbers`.
+   *
+   * Unpublished numbers allow `GET` requests. `POST`, `PUT`, `PATCH`, and `DELETE` requests that
+   * change a chat return `403` with error code `2033` (`Phone number is unpublished`).
+   *
+   * A number's existing data is preserved when its status changes to unpublished. Unpublished
+   * status alone does not block reads, blocked-handle management, or deletion
+   * of your data. Existing authorization, retention, and endpoint rules still apply.
+   *
+   * Webhook events are suppressed for affected numbers when their publication status is known to
+   * be unpublished.
+   *
    */
   availableNumber: API.AvailableNumber = new API.AvailableNumber(this);
   /**
@@ -1588,6 +1650,38 @@ export class LinqAPIV3 {
    *
    */
   experiences: API.Experiences = new API.Experiences(this);
+  /**
+   * ## SIP configuration
+   *
+   * Add these IP ranges to your SIP endpoint's allowlist:
+   *
+   * ```
+   * 54.172.60.0/30
+   * 54.244.51.0/30
+   * 168.86.128.0/18
+   * ```
+   *
+   * Set `primary_uri` to your endpoint as scheme + host — `sips:` for TLS or
+   * `sip:` for UDP, with no user part (we add it). Each call arrives at your
+   * endpoint as:
+   *
+   * ```
+   * sip:<called-number>@<your-host>
+   * ```
+   *
+   * so you can route on the dialed number. The caller's number is in the
+   * `From` header in E.164. Media (RTP) uses UDP ports 10000–60000.
+   *
+   */
+  sipProfiles: API.SipProfiles = new API.SipProfiles(this);
+  /**
+   * Read the carrier (BYOC) voice calls received on your phone numbers. Each
+   * record is the durable form of the `call_voice.*` webhooks for that call and
+   * shares the same `id`, so you can look a call up by the id a webhook
+   * delivered. See SIP Profiles for routing inbound calls to your endpoint.
+   *
+   */
+  callVoice: API.CallVoice = new API.CallVoice(this);
   /**
    * Webhook Subscriptions allow you to receive real-time notifications when events
    * occur on your account.
@@ -1881,6 +1975,8 @@ LinqAPIV3.LinkConnections = LinkConnections;
 LinqAPIV3.LinkPayments = LinkPayments;
 LinqAPIV3.BlockedHandles = BlockedHandles;
 LinqAPIV3.Experiences = Experiences;
+LinqAPIV3.SipProfiles = SipProfiles;
+LinqAPIV3.CallVoice = CallVoice;
 LinqAPIV3.WebhookEvents = WebhookEvents;
 LinqAPIV3.WebhookSubscriptions = WebhookSubscriptions;
 LinqAPIV3.Webhooks = Webhooks;
@@ -2019,6 +2115,23 @@ export declare namespace LinqAPIV3 {
     type ExperienceListResponse as ExperienceListResponse,
   };
 
+  export {
+    SipProfiles as SipProfiles,
+    type SipProfile as SipProfile,
+    type SipProfileListResponse as SipProfileListResponse,
+    type SipProfileAssignResponse as SipProfileAssignResponse,
+    type SipProfileCreateParams as SipProfileCreateParams,
+    type SipProfileUpdateParams as SipProfileUpdateParams,
+    type SipProfileAssignParams as SipProfileAssignParams,
+  };
+
+  export {
+    CallVoice as CallVoice,
+    type CallVoiceRecord as CallVoiceRecord,
+    type CallVoiceListResponse as CallVoiceListResponse,
+    type CallVoiceListParams as CallVoiceListParams,
+  };
+
   export {
     WebhookEvents as WebhookEvents,
     type WebhookEventType as WebhookEventType,
@@ -2074,6 +2187,7 @@ export declare namespace LinqAPIV3 {
     type PhoneNumberStatusUpdatedWebhookEvent as PhoneNumberStatusUpdatedWebhookEvent,
     type PhoneNumberAssignedWebhookEvent as PhoneNumberAssignedWebhookEvent,
     type PhoneNumberReleasedWebhookEvent as PhoneNumberReleasedWebhookEvent,
+    type PhoneNumberLineTypeUpdatedWebhookEvent as PhoneNumberLineTypeUpdatedWebhookEvent,
     type ConnectionCreatedWebhookEvent as ConnectionCreatedWebhookEvent,
     type ConnectionRevokedWebhookEvent as ConnectionRevokedWebhookEvent,
     type LocationSharingStartedWebhookEvent as LocationSharingStartedWebhookEvent,
@@ -2110,6 +2224,13 @@ export declare namespace LinqAPIV3 {
     type TeamMemberAddedWebhookEvent as TeamMemberAddedWebhookEvent,
     type TeamMemberSignedInWebhookEvent as TeamMemberSignedInWebhookEvent,
     type TeamMemberSignedOutWebhookEvent as TeamMemberSignedOutWebhookEvent,
+    type CallVoiceInitiatedWebhookEvent as CallVoiceInitiatedWebhookEvent,
+    type CallVoiceRingingWebhookEvent as CallVoiceRingingWebhookEvent,
+    type CallVoiceAnsweredWebhookEvent as CallVoiceAnsweredWebhookEvent,
+    type CallVoiceEndedWebhookEvent as CallVoiceEndedWebhookEvent,
+    type CallVoiceFailedWebhookEvent as CallVoiceFailedWebhookEvent,
+    type CallVoiceDeclinedWebhookEvent as CallVoiceDeclinedWebhookEvent,
+    type CallVoiceNoAnswerWebhookEvent as CallVoiceNoAnswerWebhookEvent,
     type UnwrapWebhookEvent as UnwrapWebhookEvent,
   };
 

package/src/resources/available-number.ts

@@ -21,6 +21,19 @@ import { RequestOptions } from '../internal/request-options';
  * pick an eligible number for you, skipping ineligible ones; if none of your assigned
  * numbers are eligible, you get `409` (no `from` number was ever chosen, so there's no
  * specific number to blame with a `403`).
+ *
+ * **Published vs unpublished.** A *published* number is available for your account to use.
+ * Only published numbers appear in `GET /v3/phone_numbers`.
+ *
+ * Unpublished numbers allow `GET` requests. `POST`, `PUT`, `PATCH`, and `DELETE` requests that
+ * change a chat return `403` with error code `2033` (`Phone number is unpublished`).
+ *
+ * A number's existing data is preserved when its status changes to unpublished. Unpublished
+ * status alone does not block reads, blocked-handle management, or deletion
+ * of your data. Existing authorization, retention, and endpoint rules still apply.
+ *
+ * Webhook events are suppressed for affected numbers when their publication status is known to
+ * be unpublished.
  */
 export class AvailableNumber extends APIResource {
   /**

package/src/resources/call-voice.ts

@@ -0,0 +1,110 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+/**
+ * Read the carrier (BYOC) voice calls received on your phone numbers. Each
+ * record is the durable form of the `call_voice.*` webhooks for that call and
+ * shares the same `id`, so you can look a call up by the id a webhook
+ * delivered. See SIP Profiles for routing inbound calls to your endpoint.
+ */
+export class CallVoice extends APIResource {
+  /**
+   * Retrieve a single carrier voice call by its `id` — the same id delivered in the
+   * `call_voice.*` webhooks and returned by the list endpoint. The call must belong
+   * to the authenticated partner.
+   */
+  retrieve(callVoiceID: string, options?: RequestOptions): APIPromise<CallVoiceRecord> {
+    return this._client.get(path`/v3/call-voice/${callVoiceID}`, options);
+  }
+
+  /**
+   * List the carrier voice calls received on one of your phone numbers, newest
+   * first, with cursor pagination. Each record is the durable form of the
+   * `call_voice.*` webhooks for that call; the `id` is the same id those webhooks
+   * carry. Results are scoped to the authenticated partner — a number that isn't
+   * yours (or simply has no calls) returns `200` with an empty `call_voice` array,
+   * not an error.
+   */
+  list(
+    phoneNumber: string,
+    query: CallVoiceListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CallVoiceListResponse> {
+    return this._client.get(path`/v3/phone-numbers/${phoneNumber}/call-voice`, { query, ...options });
+  }
+}
+
+/**
+ * A carrier (BYOC) inbound voice call. Mirrors the call_voice.\* webhook payload.
+ */
+export interface CallVoiceRecord {
+  /**
+   * Stable call id, identical to the id in the call_voice.\* webhooks.
+   */
+  id: string;
+
+  direction: 'inbound';
+
+  /**
+   * External caller, E.164.
+   */
+  from: string;
+
+  /**
+   * Terminal call outcome. Null while the call is still in progress; set once it
+   * ends.
+   */
+  status: 'completed' | 'busy' | 'no_answer' | 'failed' | 'canceled' | null;
+
+  /**
+   * Your line that was called, E.164.
+   */
+  to: string;
+
+  /**
+   * When the call ended. Null while still in progress.
+   */
+  ended_at?: string | null;
+
+  /**
+   * When the call was answered. Null if it never connected.
+   */
+  started_at?: string | null;
+}
+
+export interface CallVoiceListResponse {
+  /**
+   * Calls for the phone number, newest first.
+   */
+  call_voice: Array<CallVoiceRecord>;
+
+  /**
+   * Cursor for the next page of results. Null when there are no more. Pass this
+   * value as the `cursor` parameter in the next request.
+   */
+  next_cursor?: string | null;
+}
+
+export interface CallVoiceListParams {
+  /**
+   * Pagination cursor from a previous next_cursor response
+   */
+  cursor?: string;
+
+  /**
+   * Maximum number of calls to return
+   */
+  limit?: number;
+}
+
+export declare namespace CallVoice {
+  export {
+    type CallVoiceRecord as CallVoiceRecord,
+    type CallVoiceListResponse as CallVoiceListResponse,
+    type CallVoiceListParams as CallVoiceListParams,
+  };
+}

package/src/resources/chats/chats.ts

@@ -678,9 +678,9 @@ export interface MessageContent {
   >;
 
   /**
-   * Messaging service type. Where this names the transport a message used, it is
-   * per-message: a chat's own `service` can differ from a message in it, and Apple
-   * can downgrade an individual message.
+   * @deprecated Messaging service type. Where this names the transport a message
+   * used, it is per-message: a chat's own `service` can differ from a message in it,
+   * and Apple can downgrade an individual message.
    */
   preferred_service?: Shared.ServiceType;
 
@@ -1260,6 +1260,14 @@ export interface ChatCreateParams {
    */
   to: Array<string>;
 
+  /**
+   * iMessage only. If the recipient has Do Not Disturb or another Focus on and the
+   * message is delivered silently, alert them anyway (iMessage's "Notify Anyway").
+   * Best effort: ignored for SMS and RCS, and a no-op when the recipient was already
+   * notified.
+   */
+  force_notify?: boolean;
+
   /**
    * Send even though the recipient asked you to stop (`403`, error code `2024`).
    * Applies to this request only: the opt-out stays in place, so the next send
@@ -1308,6 +1316,13 @@ export interface ChatSendVoicememoParams {
    */
   attachment_id?: string;
 
+  /**
+   * iMessage only. If the recipient has Do Not Disturb or another Focus on and the
+   * voice memo is delivered silently, alert them anyway (iMessage's "Notify
+   * Anyway"). Best effort: a no-op when the recipient was already notified.
+   */
+  force_notify?: boolean;
+
   /**
    * Send even though the recipient asked you to stop (`403`, error code `2024`).
    * Applies to this request only: the opt-out stays in place, so the next send

package/src/resources/chats/messages.ts

@@ -269,9 +269,9 @@ export interface SentMessage {
   from_handle?: Shared.ChatHandle | null;
 
   /**
-   * Messaging service type. Where this names the transport a message used, it is
-   * per-message: a chat's own `service` can differ from a message in it, and Apple
-   * can downgrade an individual message.
+   * @deprecated Messaging service type. Where this names the transport a message
+   * used, it is per-message: a chat's own `service` can differ from a message in it,
+   * and Apple can downgrade an individual message.
    */
   preferred_service?: Shared.ServiceType | null;
 
@@ -491,6 +491,14 @@ export interface MessageSendParams {
    */
   message: ChatsAPI.MessageContent;
 
+  /**
+   * iMessage only. If the recipient has Do Not Disturb or another Focus on and the
+   * message is delivered silently, alert them anyway (iMessage's "Notify Anyway").
+   * Best effort: ignored for SMS and RCS, and a no-op when the recipient was already
+   * notified.
+   */
+  force_notify?: boolean;
+
   /**
    * Send even though the recipient asked you to stop (`403`, error code `2024`).
    * Applies to this request only: the opt-out stays in place, so the next send

package/src/resources/chats/polls.ts

@@ -168,7 +168,7 @@ export interface PollEnvelope {
   poll: Poll;
 
   /**
-   * Tapbacks/stickers on the whole poll (message part 0).
+   * Stickers on the whole poll (message part 0). Polls take stickers only.
    */
   reactions: Array<Shared.Reaction>;
 

package/src/resources/contact-card.ts

@@ -29,6 +29,10 @@ export class ContactCard extends APIResource {
    * existing card is never overwritten by accident. Use `PATCH /v3/contact_card` to
    * change it.
    *
+   * Contact cards are an iMessage-only feature. On a non-iMessage (SMS/RCS) line the
+   * response is `403` (`2011`) — the card is not supported there and no retry will
+   * help.
+   *
    * Rate limited per phone number: `POST` and `PATCH` share a budget of 3 calls
    * every 10 minutes. Further calls return `429`, with `Retry-After` carrying the
    * wait.
@@ -78,6 +82,10 @@ export class ContactCard extends APIResource {
    * The update did not reach the line, so the card is left not active — wait before
    * retrying, because repeated attempts extend the rate limit.
    *
+   * Contact cards are an iMessage-only feature. On a non-iMessage (SMS/RCS) line the
+   * response is `403` (`2011`) — the card is not supported there and no retry will
+   * help.
+   *
    * Rate limited per phone number: `POST` and `PATCH` share a budget of 3 calls
    * every 10 minutes. Further calls return `429`, with `Retry-After` carrying the
    * wait.

package/src/resources/index.ts

@@ -21,6 +21,12 @@ export {
   type BlockedHandleBlockParams,
   type BlockedHandleUnblockParams,
 } from './blocked-handles';
+export {
+  CallVoice,
+  type CallVoiceRecord,
+  type CallVoiceListResponse,
+  type CallVoiceListParams,
+} from './call-voice';
 export {
   Capability,
   type HandleCheck,
@@ -115,6 +121,15 @@ export {
   type PhoneNumberGetReputationAuditParams,
 } from './phone-numbers';
 export { Phonenumbers, type PhonenumberListResponse } from './phonenumbers';
+export {
+  SipProfiles,
+  type SipProfile,
+  type SipProfileListResponse,
+  type SipProfileAssignResponse,
+  type SipProfileCreateParams,
+  type SipProfileUpdateParams,
+  type SipProfileAssignParams,
+} from './sip-profiles';
 export { WebhookEvents, type WebhookEventType, type WebhookEventListResponse } from './webhook-events';
 export {
   WebhookSubscriptions,
@@ -164,6 +179,7 @@ export {
   type PhoneNumberStatusUpdatedWebhookEvent,
   type PhoneNumberAssignedWebhookEvent,
   type PhoneNumberReleasedWebhookEvent,
+  type PhoneNumberLineTypeUpdatedWebhookEvent,
   type ConnectionCreatedWebhookEvent,
   type ConnectionRevokedWebhookEvent,
   type LocationSharingStartedWebhookEvent,
@@ -200,5 +216,12 @@ export {
   type TeamMemberAddedWebhookEvent,
   type TeamMemberSignedInWebhookEvent,
   type TeamMemberSignedOutWebhookEvent,
+  type CallVoiceInitiatedWebhookEvent,
+  type CallVoiceRingingWebhookEvent,
+  type CallVoiceAnsweredWebhookEvent,
+  type CallVoiceEndedWebhookEvent,
+  type CallVoiceFailedWebhookEvent,
+  type CallVoiceDeclinedWebhookEvent,
+  type CallVoiceNoAnswerWebhookEvent,
   type UnwrapWebhookEvent,
 } from './webhooks';

package/src/resources/messages/messages.ts

@@ -138,11 +138,10 @@ export class Messages extends APIResource {
    * - Voice memos are **not** supported here. To send an iMessage voice-memo bubble,
    *   use `POST /v3/chats/{chatId}/voicememo` with a known chat id.
    *
-   * ## Service preference, effects, decorations, inline stickers
+   * ## Effects, decorations, inline stickers
    *
-   * Set `message.preferred_service` (`iMessage` | `RCS` | `SMS`), `message.effect`,
-   * and per-part `text_decorations` and `inline_stickers` exactly as on the other
-   * send endpoints.
+   * Set `message.effect` and per-part `text_decorations` and `inline_stickers`
+   * exactly as on the other send endpoints.
    *
    * Always responds `202 Accepted` — chat creation is incidental to the send.
    *
@@ -254,6 +253,9 @@ export class Messages extends APIResource {
    * `PATCH /v3/messages/{messageId}/reactions/{reactionId}`. An animated image peels
    * as an animated sticker, in whatever shape the file already has.
    *
+   * **Polls** take stickers only. Any tapback on a poll message — standard or
+   * `custom` — is rejected with a 400.
+   *
    * @example
    * ```ts
    * const response = await client.messages.addReaction(
@@ -465,9 +467,9 @@ export interface Message {
   > | null;
 
   /**
-   * Messaging service type. Where this names the transport a message used, it is
-   * per-message: a chat's own `service` can differ from a message in it, and Apple
-   * can downgrade an individual message.
+   * @deprecated Messaging service type. Where this names the transport a message
+   * used, it is per-message: a chat's own `service` can differ from a message in it,
+   * and Apple can downgrade an individual message.
    */
   preferred_service?: Shared.ServiceType | null;
 
@@ -868,6 +870,14 @@ export interface MessageCreateParams {
    */
   exclude_from?: Array<string>;
 
+  /**
+   * Body param: iMessage only. If the recipient has Do Not Disturb or another Focus
+   * on and the message is delivered silently, alert them anyway (iMessage's "Notify
+   * Anyway"). Best effort: ignored for SMS and RCS, and a no-op when the recipient
+   * was already notified.
+   */
+  force_notify?: boolean;
+
   /**
    * Body param: Send even though the recipient asked you to stop (`403`, error code
    * `2024`). Applies to this request only: the opt-out stays in place, so the next

package/src/resources/phone-numbers.ts

@@ -22,6 +22,19 @@ import { path } from '../internal/utils/path';
  * pick an eligible number for you, skipping ineligible ones; if none of your assigned
  * numbers are eligible, you get `409` (no `from` number was ever chosen, so there's no
  * specific number to blame with a `403`).
+ *
+ * **Published vs unpublished.** A *published* number is available for your account to use.
+ * Only published numbers appear in `GET /v3/phone_numbers`.
+ *
+ * Unpublished numbers allow `GET` requests. `POST`, `PUT`, `PATCH`, and `DELETE` requests that
+ * change a chat return `403` with error code `2033` (`Phone number is unpublished`).
+ *
+ * A number's existing data is preserved when its status changes to unpublished. Unpublished
+ * status alone does not block reads, blocked-handle management, or deletion
+ * of your data. Existing authorization, retention, and endpoint rules still apply.
+ *
+ * Webhook events are suppressed for affected numbers when their publication status is known to
+ * be unpublished.
  */
 export class PhoneNumbers extends APIResource {
   /**
@@ -370,6 +383,14 @@ export namespace PhoneNumberListResponse {
      */
     id: string;
 
+    /**
+     * Operational status of the line (distinct from `reputation`).
+     *
+     * - `ACTIVE` — The line is not flagged and can be used normally.
+     * - `FLAGGED` — The line has been flagged and may have limited functionality.
+     */
+    line_status: 'ACTIVE' | 'FLAGGED';
+
     /**
      * Phone number in E.164 format
      */

package/src/resources/phonenumbers.ts

@@ -21,6 +21,19 @@ import { RequestOptions } from '../internal/request-options';
  * pick an eligible number for you, skipping ineligible ones; if none of your assigned
  * numbers are eligible, you get `409` (no `from` number was ever chosen, so there's no
  * specific number to blame with a `403`).
+ *
+ * **Published vs unpublished.** A *published* number is available for your account to use.
+ * Only published numbers appear in `GET /v3/phone_numbers`.
+ *
+ * Unpublished numbers allow `GET` requests. `POST`, `PUT`, `PATCH`, and `DELETE` requests that
+ * change a chat return `403` with error code `2033` (`Phone number is unpublished`).
+ *
+ * A number's existing data is preserved when its status changes to unpublished. Unpublished
+ * status alone does not block reads, blocked-handle management, or deletion
+ * of your data. Existing authorization, retention, and endpoint rules still apply.
+ *
+ * Webhook events are suppressed for affected numbers when their publication status is known to
+ * be unpublished.
  */
 export class Phonenumbers extends APIResource {
   /**

package/src/resources/shared.ts

@@ -160,8 +160,10 @@ export interface Reaction {
   type: ReactionType;
 
   /**
-   * Identifier for this reaction. Pass it to
-   * `PATCH /v3/messages/{messageId}/reactions/{reactionId}` to move a sticker.
+   * Identifier for this reaction, the same value as `reaction_id` on the
+   * `reaction.added` and `reaction.removed` webhooks. Changing a tapback keeps the
+   * same id. Pass it to `PATCH /v3/messages/{messageId}/reactions/{reactionId}` to
+   * move a sticker.
    *
    * Stickers placed before this API shipped can be read but not moved: the
    * device-side reference needed to reposition them was never recorded, so `PATCH`