@linqapp/sdk 0.32.1 → 0.33.1

package/src/resources/chats/chats.ts

@@ -1,11 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as MessagesAPI from '../messages';
 import * as Shared from '../shared';
 import * as LocationAPI from './location';
 import { GetChatLocationResponse, Location, LocationRequestResponse } from './location';
-import * as ChatsMessagesAPI from './messages';
+import * as MessagesAPI from './messages';
 import { MessageListParams, MessageSendParams, MessageSendResponse, Messages, SentMessage } from './messages';
 import * as ParticipantsAPI from './participants';
 import {
@@ -15,8 +14,11 @@ import {
   ParticipantRemoveResponse,
   Participants,
 } from './participants';
+import * as PollsAPI from './polls';
+import { Poll, PollCreateParams, PollEnvelope, Polls } from './polls';
 import * as TypingAPI from './typing';
 import { Typing } from './typing';
+import * as ResourcesMessagesAPI from '../messages/messages';
 import { APIPromise } from '../../core/api-promise';
 import { ListChatsPagination, type ListChatsPaginationParams, PagePromise } from '../../core/pagination';
 import { buildHeaders } from '../../internal/headers';
@@ -26,8 +28,9 @@ import { path } from '../../internal/utils/path';
 export class Chats extends APIResource {
   participants: ParticipantsAPI.Participants = new ParticipantsAPI.Participants(this._client);
   typing: TypingAPI.Typing = new TypingAPI.Typing(this._client);
-  messages: ChatsMessagesAPI.Messages = new ChatsMessagesAPI.Messages(this._client);
+  messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
   location: LocationAPI.Location = new LocationAPI.Location(this._client);
+  polls: PollsAPI.Polls = new PollsAPI.Polls(this._client);
 
   /**
    * Create a new chat with specified participants and send an initial message. The
@@ -122,46 +125,6 @@ export class Chats extends APIResource {
     return this._client.post('/v3/chats', { body, ...options });
   }
 
-  /**
-   * Retrieves a paginated list of chats for the authenticated partner.
-   *
-   * **Filtering:**
-   *
-   * - If `from` is provided, returns chats for that specific phone number
-   * - If `from` is omitted, returns chats across all phone numbers owned by the
-   *   partner
-   * - If `to` is provided, only returns chats where the specified handle is a
-   *   participant
-   *
-   * **Pagination:**
-   *
-   * - Use `limit` to control page size (default: 20, max: 100)
-   * - The response includes `next_cursor` for fetching the next page
-   * - When `next_cursor` is `null`, there are no more results to fetch
-   * - Pass the `next_cursor` value as the `cursor` parameter for the next request
-   *
-   * **Example pagination flow:**
-   *
-   * 1. First request: `GET /v3/chats?from=%2B12223334444&limit=20`
-   * 2. Response includes `next_cursor: "20"` (more results exist)
-   * 3. Next request: `GET /v3/chats?from=%2B12223334444&limit=20&cursor=20`
-   * 4. Response includes `next_cursor: null` (no more results)
-   *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const chat of client.chats.listChats()) {
-   *   // ...
-   * }
-   * ```
-   */
-  listChats(
-    query: ChatListChatsParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<ChatsListChatsPagination, Chat> {
-    return this._client.getAPIList('/v3/chats', ListChatsPagination<Chat>, { query, ...options });
-  }
-
   /**
    * Retrieve a chat by its unique identifier.
    *
@@ -195,23 +158,6 @@ export class Chats extends APIResource {
     return this._client.put(path`/v3/chats/${chatID}`, { body, ...options });
   }
 
-  /**
-   * Mark all messages in a chat as read.
-   *
-   * @example
-   * ```ts
-   * await client.chats.markAsRead(
-   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   * );
-   * ```
-   */
-  markAsRead(chatID: string, options?: RequestOptions): APIPromise<void> {
-    return this._client.post(path`/v3/chats/${chatID}/read`, {
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
-  }
-
   /**
    * Removes your phone number from a group chat. Once you leave, you will no longer
    * receive messages from the group and all interaction endpoints (send message,
@@ -239,21 +185,57 @@ export class Chats extends APIResource {
   }
 
   /**
-   * Share your contact information (Name and Photo Sharing) with a chat.
+   * Retrieves a paginated list of chats for the authenticated partner.
    *
-   * **Note:** A contact card must be configured before sharing. You can set up your
-   * contact card via the [Contact Card API](#tag/Contact-Card) or on the
-   * [Linq dashboard](https://dashboard.linqapp.com/contact-cards).
+   * **Filtering:**
+   *
+   * - If `from` is provided, returns chats for that specific phone number
+   * - If `from` is omitted, returns chats across all phone numbers owned by the
+   *   partner
+   * - If `to` is provided, only returns chats where the specified handle is a
+   *   participant
+   *
+   * **Pagination:**
+   *
+   * - Use `limit` to control page size (default: 20, max: 100)
+   * - The response includes `next_cursor` for fetching the next page
+   * - When `next_cursor` is `null`, there are no more results to fetch
+   * - Pass the `next_cursor` value as the `cursor` parameter for the next request
+   *
+   * **Example pagination flow:**
+   *
+   * 1. First request: `GET /v3/chats?from=%2B12223334444&limit=20`
+   * 2. Response includes `next_cursor: "20"` (more results exist)
+   * 3. Next request: `GET /v3/chats?from=%2B12223334444&limit=20&cursor=20`
+   * 4. Response includes `next_cursor: null` (no more results)
    *
    * @example
    * ```ts
-   * await client.chats.shareContactCard(
+   * // Automatically fetches more pages as needed.
+   * for await (const chat of client.chats.listChats()) {
+   *   // ...
+   * }
+   * ```
+   */
+  listChats(
+    query: ChatListChatsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ChatsListChatsPagination, Chat> {
+    return this._client.getAPIList('/v3/chats', ListChatsPagination<Chat>, { query, ...options });
+  }
+
+  /**
+   * Mark all messages in a chat as read.
+   *
+   * @example
+   * ```ts
+   * await client.chats.markAsRead(
    *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
    * );
    * ```
    */
-  shareContactCard(chatID: string, options?: RequestOptions): APIPromise<void> {
-    return this._client.post(path`/v3/chats/${chatID}/share_contact_card`, {
+  markAsRead(chatID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/v3/chats/${chatID}/read`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -290,6 +272,27 @@ export class Chats extends APIResource {
   ): APIPromise<ChatSendVoicememoResponse> {
     return this._client.post(path`/v3/chats/${chatID}/voicememo`, { body, ...options });
   }
+
+  /**
+   * Share your contact information (Name and Photo Sharing) with a chat.
+   *
+   * **Note:** A contact card must be configured before sharing. You can set up your
+   * contact card via the [Contact Card API](#tag/Contact-Card) or on the
+   * [Linq dashboard](https://dashboard.linqapp.com/contact-cards).
+   *
+   * @example
+   * ```ts
+   * await client.chats.shareContactCard(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * );
+   * ```
+   */
+  shareContactCard(chatID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/v3/chats/${chatID}/share_contact_card`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
 }
 
 export type ChatsListChatsPagination = ListChatsPagination<Chat>;
@@ -383,6 +386,21 @@ export namespace Chat {
      * Current health bucket for the chat. See the
      * [Chat Health guide](/guides/chats/chat-health) for what each value means and how
      * to react. `doc_url` deep-links to the relevant section.
+     *
+     * `OPTED_OUT` is terminal — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`,
+     * `CANCEL`, `END`, or `QUIT`. The keyword must be the whole trimmed message, never
+     * part of a longer one: `STOP` counts, `please stop` does not. Most keywords must
+     * match exactly, including case. `OPT OUT` is the exception — it matches in any
+     * casing, with or without the space or a hyphen, so `opt out`, `Opt-Out` and
+     * `optout` all count. It clears if they later send `START`, `OPTIN`, or `UNSTOP`,
+     * or if they keep replying on the chat — sustained two-way conversation is treated
+     * as a sign the stop keyword was a false positive.
+     *
+     * Linq enforces this: while a recipient is opted out, every send to them is
+     * rejected with `403` (error code `2024`) before the message is queued, across
+     * every chat and every line on your account. Nothing is delivered, including a
+     * final courtesy message — to send one, set `override_optout: true` on that single
+     * request.
      */
     status: 'HEALTHY' | 'AT_RISK' | 'CRITICAL' | 'OPTED_OUT';
 
@@ -468,14 +486,26 @@ export interface MediaPart {
  * cannot coexist with text), so copy and a card are two sends, not one.
  */
 export interface MessageContent {
+  /**
+   * Invokes an action on an experience — a third party that renders inside Linq's
+   * iMessage app. Linq resolves the recipient's connection, mints any session the
+   * action needs, composes the card and sends it; none of that is visible to you.
+   *
+   * Call `GET /v3/experiences/{experience}` for the actions you may invoke and the
+   * fields each accepts.
+   */
+  action?: MessageContent.Action;
+
   /**
    * iMessage effect to apply to this message (screen or bubble effect)
    */
-  effect?: MessagesAPI.MessageEffect;
+  effect?: ResourcesMessagesAPI.MessageEffect;
 
   /**
    * Optional idempotency key for this message. Use this to prevent duplicate sends
-   * of the same message.
+   * of the same message. Reusing a key whose message was deleted — or was an
+   * ephemeral message that has since expired — returns 404; the message is never
+   * resent.
    */
   idempotency_key?: string;
 
@@ -528,10 +558,39 @@ export interface MessageContent {
   /**
    * Reply to another message to create a threaded conversation
    */
-  reply_to?: MessagesAPI.ReplyTo;
+  reply_to?: ResourcesMessagesAPI.ReplyTo;
 }
 
 export namespace MessageContent {
+  /**
+   * Invokes an action on an experience — a third party that renders inside Linq's
+   * iMessage app. Linq resolves the recipient's connection, mints any session the
+   * action needs, composes the card and sends it; none of that is visible to you.
+   *
+   * Call `GET /v3/experiences/{experience}` for the actions you may invoke and the
+   * fields each accepts.
+   */
+  export interface Action {
+    /**
+     * Which of its actions, e.g. `attach_card`.
+     */
+    action: string;
+
+    /**
+     * The experience to invoke, e.g. `agentcard`.
+     */
+    experience: string;
+
+    /**
+     * Values for the fields this action exposes. Keys are exactly the field names
+     * listed for the action — no mapping, no nesting.
+     *
+     * Display copy only, except a `url`-type field — that value sets the destination,
+     * and must be an absolute `https` URL.
+     */
+    params?: { [key: string]: unknown };
+  }
+
   /**
    * An iMessage app card, backed by a Messages app extension. iMessage only — an
    * `imessage_app` part must be the **only** part in the message and is never
@@ -692,6 +751,26 @@ export interface TextPart {
    */
   value: string;
 
+  /**
+   * @mention a chat participant (iMessage group chats only). Set to their handle —
+   * E.164 phone number or Apple ID email. `value` is the display text; use the bare
+   * name (`"Juan"`, not `"@Juan"`). The mentioned participant is notified even if
+   * the chat is muted. Falls back to plain text over SMS/RCS.
+   *
+   * By default the entire `value` renders as the mention; use `mention_range` to
+   * highlight only part of it.
+   */
+  mention?: string;
+
+  /**
+   * Optional character range `[start, end)` in `value` that renders as the `mention`
+   * highlight (e.g. just the name in `"Hey Kevin, can you look at this?"`). Requires
+   * `mention`. Without it, the entire `value` is highlighted. `start` is inclusive,
+   * `end` is exclusive. _Characters are measured as UTF-16 code units. Most
+   * characters count as 1; some emoji count as 2._
+   */
+  mention_range?: Array<number>;
+
   /**
    * Optional array of text decorations applied to character ranges in the `value`
    * field (iMessage only).
@@ -763,7 +842,7 @@ export namespace ChatCreateResponse {
     /**
      * A message that was sent (used in CreateChat and SendMessage responses)
      */
-    message: ChatsMessagesAPI.SentMessage;
+    message: MessagesAPI.SentMessage;
 
     /**
      * Messaging service type
@@ -795,6 +874,21 @@ export namespace ChatCreateResponse {
        * Current health bucket for the chat. See the
        * [Chat Health guide](/guides/chats/chat-health) for what each value means and how
        * to react. `doc_url` deep-links to the relevant section.
+       *
+       * `OPTED_OUT` is terminal — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`,
+       * `CANCEL`, `END`, or `QUIT`. The keyword must be the whole trimmed message, never
+       * part of a longer one: `STOP` counts, `please stop` does not. Most keywords must
+       * match exactly, including case. `OPT OUT` is the exception — it matches in any
+       * casing, with or without the space or a hyphen, so `opt out`, `Opt-Out` and
+       * `optout` all count. It clears if they later send `START`, `OPTIN`, or `UNSTOP`,
+       * or if they keep replying on the chat — sustained two-way conversation is treated
+       * as a sign the stop keyword was a false positive.
+       *
+       * Linq enforces this: while a recipient is opted out, every send to them is
+       * rejected with `403` (error code `2024`) before the message is queued, across
+       * every chat and every line on your account. Nothing is delivered, including a
+       * final courtesy message — to send one, set `override_optout: true` on that single
+       * request.
        */
       status: 'HEALTHY' | 'AT_RISK' | 'CRITICAL' | 'OPTED_OUT';
 
@@ -950,6 +1044,26 @@ export interface ChatCreateParams {
    * For individual chats, provide one recipient. For group chats, provide multiple.
    */
   to: Array<string>;
+
+  /**
+   * 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
+   * without this flag is rejected again. Every override is recorded against your API
+   * key.
+   */
+  override_optout?: boolean;
+}
+
+export interface ChatUpdateParams {
+  /**
+   * New display name for the chat (group chats only)
+   */
+  display_name?: string;
+
+  /**
+   * URL of an image to set as the group chat icon (group chats only)
+   */
+  group_chat_icon?: string;
 }
 
 export interface ChatListChatsParams extends ListChatsPaginationParams {
@@ -970,18 +1084,6 @@ export interface ChatListChatsParams extends ListChatsPaginationParams {
   to?: string;
 }
 
-export interface ChatUpdateParams {
-  /**
-   * New display name for the chat (group chats only)
-   */
-  display_name?: string;
-
-  /**
-   * URL of an image to set as the group chat icon (group chats only)
-   */
-  group_chat_icon?: string;
-}
-
 export interface ChatSendVoicememoParams {
   /**
    * Reference to a voice memo file pre-uploaded via `POST /v3/attachments`. The file
@@ -991,6 +1093,14 @@ export interface ChatSendVoicememoParams {
    */
   attachment_id?: string;
 
+  /**
+   * 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
+   * without this flag is rejected again. Every override is recorded against your API
+   * key.
+   */
+  override_optout?: boolean;
+
   /**
    * URL of the voice memo audio file. Must be a publicly accessible HTTPS URL.
    *
@@ -1003,6 +1113,7 @@ Chats.Participants = Participants;
 Chats.Typing = Typing;
 Chats.Messages = Messages;
 Chats.Location = Location;
+Chats.Polls = Polls;
 
 export declare namespace Chats {
   export {
@@ -1017,8 +1128,8 @@ export declare namespace Chats {
     type ChatSendVoicememoResponse as ChatSendVoicememoResponse,
     type ChatsListChatsPagination as ChatsListChatsPagination,
     type ChatCreateParams as ChatCreateParams,
-    type ChatListChatsParams as ChatListChatsParams,
     type ChatUpdateParams as ChatUpdateParams,
+    type ChatListChatsParams as ChatListChatsParams,
     type ChatSendVoicememoParams as ChatSendVoicememoParams,
   };
 
@@ -1036,8 +1147,8 @@ export declare namespace Chats {
     Messages as Messages,
     type SentMessage as SentMessage,
     type MessageSendResponse as MessageSendResponse,
-    type MessageSendParams as MessageSendParams,
     type MessageListParams as MessageListParams,
+    type MessageSendParams as MessageSendParams,
   };
 
   export {
@@ -1045,4 +1156,11 @@ export declare namespace Chats {
     type GetChatLocationResponse as GetChatLocationResponse,
     type LocationRequestResponse as LocationRequestResponse,
   };
+
+  export {
+    Polls as Polls,
+    type Poll as Poll,
+    type PollEnvelope as PollEnvelope,
+    type PollCreateParams as PollCreateParams,
+  };
 }

package/src/resources/chats/index.ts

@@ -12,8 +12,8 @@ export {
   type ChatLeaveChatResponse,
   type ChatSendVoicememoResponse,
   type ChatCreateParams,
-  type ChatListChatsParams,
   type ChatUpdateParams,
+  type ChatListChatsParams,
   type ChatSendVoicememoParams,
   type ChatsListChatsPagination,
 } from './chats';
@@ -22,8 +22,8 @@ export {
   Messages,
   type SentMessage,
   type MessageSendResponse,
-  type MessageSendParams,
   type MessageListParams,
+  type MessageSendParams,
 } from './messages';
 export {
   Participants,
@@ -32,4 +32,5 @@ export {
   type ParticipantAddParams,
   type ParticipantRemoveParams,
 } from './participants';
+export { Polls, type Poll, type PollEnvelope, type PollCreateParams } from './polls';
 export { Typing } from './typing';

package/src/resources/chats/location.ts

@@ -45,34 +45,6 @@ import { path } from '../../internal/utils/path';
  * Messages conversation** with your number.
  */
 export class Location extends APIResource {
-  /**
-   * Request a contact in a chat to share their location. They receive an iMessage
-   * prompt and must accept before any location is available; once they do, read
-   * their location coordinates with `GET /v3/chats/{chatId}/location`.
-   *
-   * The request is delivered asynchronously. The endpoint returns immediately with
-   * `{ "success": true, "message": "Location request sent" }` and does not return
-   * coordinates.
-   *
-   * Location requests only work in **1:1 iMessage chats** (Apple limitation):
-   *
-   * - Group chats (any service) return `409` with code `2016`
-   *   (`GroupChatNotSupported`).
-   * - 1:1 SMS and RCS chats return `409` with code `2017`
-   *   (`ChatServiceNotSupported`).
-   *
-   * @example
-   * ```ts
-   * const locationRequestResponse =
-   *   await client.chats.location.request(
-   *     '975d0776-bd17-4273-8337-f346b4c661b0',
-   *   );
-   * ```
-   */
-  request(chatID: string, options?: RequestOptions): APIPromise<LocationRequestResponse> {
-    return this._client.post(path`/v3/chats/${chatID}/location/request`, options);
-  }
-
   /**
    * Retrieve the current location for contacts sharing with you in a chat.
    *
@@ -107,6 +79,34 @@ export class Location extends APIResource {
       headers: buildHeaders([{ Accept: 'application/geo+json' }, options?.headers]),
     });
   }
+
+  /**
+   * Request a contact in a chat to share their location. They receive an iMessage
+   * prompt and must accept before any location is available; once they do, read
+   * their location coordinates with `GET /v3/chats/{chatId}/location`.
+   *
+   * The request is delivered asynchronously. The endpoint returns immediately with
+   * `{ "success": true, "message": "Location request sent" }` and does not return
+   * coordinates.
+   *
+   * Location requests only work in **1:1 iMessage chats** (Apple limitation):
+   *
+   * - Group chats (any service) return `409` with code `2016`
+   *   (`GroupChatNotSupported`).
+   * - 1:1 SMS and RCS chats return `409` with code `2017`
+   *   (`ChatServiceNotSupported`).
+   *
+   * @example
+   * ```ts
+   * const locationRequestResponse =
+   *   await client.chats.location.request(
+   *     '975d0776-bd17-4273-8337-f346b4c661b0',
+   *   );
+   * ```
+   */
+  request(chatID: string, options?: RequestOptions): APIPromise<LocationRequestResponse> {
+    return this._client.post(path`/v3/chats/${chatID}/location/request`, options);
+  }
 }
 
 export interface GetChatLocationResponse {

package/src/resources/chats/messages.ts

@@ -1,10 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as MessagesAPI from '../messages';
-import { MessagesListMessagesPagination } from '../messages';
 import * as Shared from '../shared';
 import * as ChatsAPI from './chats';
+import * as ResourcesMessagesAPI from '../messages/messages';
+import { MessagesListMessagesPagination } from '../messages/messages';
 import { APIPromise } from '../../core/api-promise';
 import {
   ListMessagesPagination,
@@ -75,6 +75,31 @@ import { path } from '../../internal/utils/path';
  * **Important:** ephemeral applies in *both directions* — messages you send **and** messages received by the phone numbers in that scope. Because Linq can no longer return the message after 24 hours, persist anything you need to keep from the webhook payload at the time it is delivered.
  */
 export class Messages extends APIResource {
+  /**
+   * Retrieve messages from a specific chat with pagination support.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const message of client.chats.messages.list(
+   *   '550e8400-e29b-41d4-a716-446655440000',
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    chatID: string,
+    query: MessageListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<MessagesListMessagesPagination, ResourcesMessagesAPI.Message> {
+    return this._client.getAPIList(
+      path`/v3/chats/${chatID}/messages`,
+      ListMessagesPagination<ResourcesMessagesAPI.Message>,
+      { query, ...options },
+    );
+  }
+
   /**
    * Send a message to an existing chat. Use this endpoint when you already have a
    * chat ID and want to send additional messages to it.
@@ -134,31 +159,6 @@ export class Messages extends APIResource {
   send(chatID: string, body: MessageSendParams, options?: RequestOptions): APIPromise<MessageSendResponse> {
     return this._client.post(path`/v3/chats/${chatID}/messages`, { body, ...options });
   }
-
-  /**
-   * Retrieve messages from a specific chat with pagination support.
-   *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const message of client.chats.messages.list(
-   *   '550e8400-e29b-41d4-a716-446655440000',
-   * )) {
-   *   // ...
-   * }
-   * ```
-   */
-  list(
-    chatID: string,
-    query: MessageListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<MessagesListMessagesPagination, MessagesAPI.Message> {
-    return this._client.getAPIList(
-      path`/v3/chats/${chatID}/messages`,
-      ListMessagesPagination<MessagesAPI.Message>,
-      { query, ...options },
-    );
-  }
 }
 
 /**
@@ -209,7 +209,7 @@ export interface SentMessage {
   /**
    * iMessage effect applied to a message (screen or bubble effect)
    */
-  effect?: MessagesAPI.MessageEffect | null;
+  effect?: ResourcesMessagesAPI.MessageEffect | null;
 
   /**
    * The sender of this message as a full handle object
@@ -224,7 +224,7 @@ export interface SentMessage {
   /**
    * Indicates this message is a threaded reply to another message
    */
-  reply_to?: MessagesAPI.ReplyTo | null;
+  reply_to?: ResourcesMessagesAPI.ReplyTo | null;
 
   /**
    * Messaging service type
@@ -384,6 +384,8 @@ export interface MessageSendResponse {
   message: SentMessage;
 }
 
+export interface MessageListParams extends ListMessagesPaginationParams {}
+
 export interface MessageSendParams {
   /**
    * Message content container. Groups all message-related fields together,
@@ -396,16 +398,22 @@ export interface MessageSendParams {
    * cannot coexist with text), so copy and a card are two sends, not one.
    */
   message: ChatsAPI.MessageContent;
-}
 
-export interface MessageListParams extends ListMessagesPaginationParams {}
+  /**
+   * 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
+   * without this flag is rejected again. Every override is recorded against your API
+   * key.
+   */
+  override_optout?: boolean;
+}
 
 export declare namespace Messages {
   export {
     type SentMessage as SentMessage,
     type MessageSendResponse as MessageSendResponse,
-    type MessageSendParams as MessageSendParams,
     type MessageListParams as MessageListParams,
+    type MessageSendParams as MessageSendParams,
   };
 }