@linqapp/sdk 0.80.0 → 0.82.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.
    *
@@ -239,7 +238,8 @@ export class Messages extends APIResource {
    * - laugh 😂
    * - emphasize ‼️
    * - question ❓
-   * - custom - any emoji as a tapback (use `custom_emoji` field to specify)
+   * - custom - any emoji or image as a tapback (use `custom_emoji` for an emoji, or
+   *   `url` / `attachment_id` for an image)
    * - sticker - an emoji or image peeled onto the message (use `emoji`, `url` or
    *   `attachment_id`)
    *
@@ -248,12 +248,18 @@ export class Messages extends APIResource {
    * `sticker` is peeled onto the bubble itself, and can be dragged, resized and
    * rotated. Both accept an emoji; they do not look alike.
    *
+   * **Image tapbacks** are iMessage-only. Remove one with `operation: "remove"` and
+   * `type: "custom"`; no image is needed.
+   *
    * **Stickers** are iMessage-only and cannot be removed, so `operation: "remove"`
    * with `type: "sticker"` is rejected. Position, size and rotation are optional via
    * `placement`, and can be changed afterwards with
    * `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 +471,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 +874,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
@@ -922,15 +936,17 @@ export interface MessageAddReactionParams {
 
   /**
    * Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh,
-   * emphasize, question. Custom emoji reactions have type "custom" with the actual
-   * emoji in the custom_emoji field. Sticker reactions have type "sticker" with
-   * sticker attachment details in the sticker field.
+   * emphasize, question. Custom tapbacks have type "custom": an emoji tapback
+   * carries the emoji in the custom_emoji field, and an image tapback carries the
+   * image in the sticker field. Sticker reactions have type "sticker" with sticker
+   * attachment details in the sticker field.
    */
   type: Shared.ReactionType;
 
   /**
-   * Reference to a sticker image pre-uploaded via `POST /v3/attachments`. Only valid
-   * when type is "sticker".
+   * Reference to an image pre-uploaded via `POST /v3/attachments`. Valid when type
+   * is "sticker", or when adding a type "custom" reaction to make it an image
+   * tapback.
    *
    * Exactly one of `emoji`, `url` or `attachment_id` is required when type is
    * "sticker".
@@ -938,7 +954,9 @@ export interface MessageAddReactionParams {
   attachment_id?: string;
 
   /**
-   * Custom emoji string. Required when type is "custom".
+   * Custom emoji string. When adding a type "custom" reaction, provide exactly one
+   * of `custom_emoji`, `url` or `attachment_id`. To remove an emoji reaction, pass
+   * the same `custom_emoji`.
    *
    * This is a **tapback** — the emoji sits in the tapback bubble on the corner of
    * the message. To peel an emoji onto the message as a draggable sticker instead,
@@ -973,11 +991,12 @@ export interface MessageAddReactionParams {
   placement?: MessageAddReactionParams.Placement;
 
   /**
-   * Linq attachment URL of the sticker image — the `download_url` returned by
-   * `POST /v3/attachments`. Only valid when type is "sticker".
+   * Linq attachment URL of the image — the `download_url` returned by
+   * `POST /v3/attachments`. Valid when type is "sticker", or when adding a type
+   * "custom" reaction to make it an image tapback.
    *
-   * The image must already be stored with us. To send a sticker from elsewhere,
-   * upload it with `POST /v3/attachments` first and pass `attachment_id`.
+   * The image must already be stored with us. To use an image from elsewhere, upload
+   * it with `POST /v3/attachments` first and pass `attachment_id`.
    *
    * Exactly one of `emoji`, `url` or `attachment_id` is required when type is
    * "sticker".

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 {
   /**