@sentdm/sentdm 0.34.0 → 0.35.0

package/resources/messages.d.mts

@@ -1,9 +1,12 @@
 import { APIResource } from "../core/resource.mjs";
-import * as WebhooksAPI from "./webhooks.mjs";
 import { APIPromise } from "../core/api-promise.mjs";
 import { RequestOptions } from "../internal/request-options.mjs";
 /**
- * Send and track SMS and WhatsApp messages
+ * Send a message and follow what happened to it.
+ *
+ * One endpoint sends on any channel: pass `channel: "sent"` and we pick between SMS, WhatsApp and RCS per recipient using your routing rules, or name a channel to pin it. A send is accepted asynchronously — `POST /v3/messages` returns an id, and delivery is reported through `GET /v3/messages/{id}`, its activities, or a webhook.
+ *
+ * **A message needs a sender.** What you can send, where, and at what cost is decided by the markets under **Channels** — so a recipient in a country you hold no sender for is refused here rather than queued.
  */
 export declare class Messages extends APIResource {
     /**
@@ -60,11 +63,11 @@ export interface MessageRetrieveActivitiesResponse {
     /**
      * Error information
      */
-    error?: WebhooksAPI.ErrorDetail | null;
+    error?: MessageRetrieveActivitiesResponse.Error | null;
     /**
      * Request and response metadata
      */
-    meta?: WebhooksAPI.APIMeta;
+    meta?: MessageRetrieveActivitiesResponse.Meta;
     /**
      * Indicates whether the request was successful
      */
@@ -83,6 +86,10 @@ export declare namespace MessageRetrieveActivitiesResponse {
          * The message ID these activities belong to
          */
         message_id?: string;
+        /**
+         * Pagination metadata for list responses
+         */
+        pagination?: Data.Pagination;
     }
     namespace Data {
         /**
@@ -119,6 +126,90 @@ export declare namespace MessageRetrieveActivitiesResponse {
              */
             timestamp?: string;
         }
+        /**
+         * Pagination metadata for list responses
+         */
+        interface Pagination {
+            /**
+             * @deprecated Cursor-based pagination. Never populated — see Cursors.
+             */
+            cursors?: Pagination.Cursors | null;
+            /**
+             * Whether there are more pages after this one
+             */
+            has_more?: boolean;
+            /**
+             * Current page number (1-indexed)
+             */
+            page?: number;
+            /**
+             * Number of items per page
+             */
+            page_size?: number;
+            /**
+             * Total number of items across all pages
+             */
+            total_count?: number;
+            /**
+             * Total number of pages
+             */
+            total_pages?: number;
+        }
+        namespace Pagination {
+            /**
+             * @deprecated Cursor-based pagination. Never populated — see Cursors.
+             */
+            interface Cursors {
+                /**
+                 * Cursor to fetch the next page.
+                 */
+                after?: string | null;
+                /**
+                 * Cursor to fetch the previous page.
+                 */
+                before?: string | null;
+            }
+        }
+    }
+    /**
+     * Error information
+     */
+    interface Error {
+        /**
+         * Machine-readable error code (e.g., "RESOURCE_001")
+         */
+        code?: string;
+        /**
+         * Additional validation error details (field-level errors)
+         */
+        details?: {
+            [key: string]: Array<string>;
+        } | null;
+        /**
+         * URL to documentation about this error
+         */
+        doc_url?: string | null;
+        /**
+         * Human-readable error message
+         */
+        message?: string;
+    }
+    /**
+     * Request and response metadata
+     */
+    interface Meta {
+        /**
+         * Unique identifier for this request (for tracing and support)
+         */
+        request_id?: string;
+        /**
+         * Server timestamp when the response was generated
+         */
+        timestamp?: string;
+        /**
+         * API version used for this request
+         */
+        version?: string;
     }
 }
 /**
@@ -132,11 +223,11 @@ export interface MessageRetrieveStatusResponse {
     /**
      * Error information
      */
-    error?: WebhooksAPI.ErrorDetail | null;
+    error?: MessageRetrieveStatusResponse.Error | null;
     /**
      * Request and response metadata
      */
-    meta?: WebhooksAPI.APIMeta;
+    meta?: MessageRetrieveStatusResponse.Meta;
     /**
      * Indicates whether the request was successful
      */
@@ -197,23 +288,72 @@ export declare namespace MessageRetrieveStatusResponse {
             }
         }
     }
+    /**
+     * Error information
+     */
+    interface Error {
+        /**
+         * Machine-readable error code (e.g., "RESOURCE_001")
+         */
+        code?: string;
+        /**
+         * Additional validation error details (field-level errors)
+         */
+        details?: {
+            [key: string]: Array<string>;
+        } | null;
+        /**
+         * URL to documentation about this error
+         */
+        doc_url?: string | null;
+        /**
+         * Human-readable error message
+         */
+        message?: string;
+    }
+    /**
+     * Request and response metadata
+     */
+    interface Meta {
+        /**
+         * Unique identifier for this request (for tracing and support)
+         */
+        request_id?: string;
+        /**
+         * Server timestamp when the response was generated
+         */
+        timestamp?: string;
+        /**
+         * API version used for this request
+         */
+        version?: string;
+    }
 }
 /**
  * Standard API response envelope for all v3 endpoints
  */
 export interface MessageSendResponse {
     /**
-     * Response for the multi-recipient send message endpoint
+     * The result of a multi-recipient send.
+     *
+     * Declared here rather than in the service layer. POST /v3/messages used to
+     * publish MessageSendResult — a type in Common.Services.Messaging.Contracts — so
+     * the public contract was whatever the send service happened to return, and
+     * changing that service for an internal reason changed the API. The service keeps
+     * its result; this is what a caller sees, and the mapping between them is a
+     * decision the endpoint makes.
+     *
+     * The wire is unchanged by the move: same names, same values.
      */
     data?: MessageSendResponse.Data | null;
     /**
      * Error information
      */
-    error?: WebhooksAPI.ErrorDetail | null;
+    error?: MessageSendResponse.Error | null;
     /**
      * Request and response metadata
      */
-    meta?: WebhooksAPI.APIMeta;
+    meta?: MessageSendResponse.Meta;
     /**
      * Indicates whether the request was successful
      */
@@ -221,51 +361,90 @@ export interface MessageSendResponse {
 }
 export declare namespace MessageSendResponse {
     /**
-     * Response for the multi-recipient send message endpoint
+     * The result of a multi-recipient send.
+     *
+     * Declared here rather than in the service layer. POST /v3/messages used to
+     * publish MessageSendResult — a type in Common.Services.Messaging.Contracts — so
+     * the public contract was whatever the send service happened to return, and
+     * changing that service for an internal reason changed the API. The service keeps
+     * its result; this is what a caller sees, and the mapping between them is a
+     * decision the endpoint makes.
+     *
+     * The wire is unchanged by the move: same names, same values.
      */
     interface Data {
-        /**
-         * Per-recipient message results
-         */
         recipients?: Array<Data.Recipient>;
         /**
-         * Overall request status: "QUEUED" when the batch has been accepted for delivery.
+         * Overall status — QUEUED once the batch is accepted for delivery.
          */
         status?: string;
-        /**
-         * Template ID that was used
-         */
         template_id?: string;
-        /**
-         * Template display name
-         */
         template_name?: string;
     }
     namespace Data {
         /**
-         * Per-recipient result in the send message response
+         * What one recipient of a send got, as the API reports it.
          */
         interface Recipient {
             /**
-             * Resolved template body text for this recipient's channel, or null for
-             * auto-detect
+             * Resolved template body for this recipient's channel, or null when the channel is
+             * auto-detected.
              */
             body?: string | null;
             /**
-             * Channel this message will be sent on (e.g. "sms", "whatsapp"), or null for
-             * auto-detect
+             * Channel this message will be sent on — sms, whatsapp — or null to auto-detect.
              */
             channel?: string | null;
             /**
-             * Unique message identifier for tracking this recipient's message
+             * Identifier for tracking this recipient's message.
              */
             message_id?: string;
             /**
-             * Phone number in E.164 format
+             * Phone number in E.164 format.
              */
             to?: string;
         }
     }
+    /**
+     * Error information
+     */
+    interface Error {
+        /**
+         * Machine-readable error code (e.g., "RESOURCE_001")
+         */
+        code?: string;
+        /**
+         * Additional validation error details (field-level errors)
+         */
+        details?: {
+            [key: string]: Array<string>;
+        } | null;
+        /**
+         * URL to documentation about this error
+         */
+        doc_url?: string | null;
+        /**
+         * Human-readable error message
+         */
+        message?: string;
+    }
+    /**
+     * Request and response metadata
+     */
+    interface Meta {
+        /**
+         * Unique identifier for this request (for tracing and support)
+         */
+        request_id?: string;
+        /**
+         * Server timestamp when the response was generated
+         */
+        timestamp?: string;
+        /**
+         * API version used for this request
+         */
+        version?: string;
+    }
 }
 export interface MessageRetrieveActivitiesParams {
     /**

package/resources/messages.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.mts","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EAAE,UAAU,EAAE,gCAA4B;AAEjD,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAG7D;;GAEG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;OAUG;IACH,kBAAkB,CAChB,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,+BAA+B,GAAG,IAAI,GAAG,SAAc,EAC/D,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,iCAAiC,CAAC;IAWhD;;;;;;;;;;OAUG;IACH,cAAc,CACZ,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,2BAA2B,GAAG,IAAI,GAAG,SAAc,EAC3D,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,6BAA6B,CAAC;IAW5C;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;CAc3F;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,IAAI,CAAC,EAAE,iCAAiC,CAAC,IAAI,GAAG,IAAI,CAAC;IAErD;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC;IAEvC;;OAEG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,yBAAiB,iCAAiC,CAAC;IACjD;;OAEG;IACH,UAAiB,IAAI;QACnB;;WAEG;QACH,UAAU,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAElC;;WAEG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAED,UAAiB,IAAI,CAAC;QACpB;;WAEG;QACH,UAAiB,QAAQ;YACvB;;;eAGG;YACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAErC;;eAEG;YACH,WAAW,CAAC,EAAE,MAAM,CAAC;YAErB;;;;eAIG;YACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAErB;;;eAGG;YACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAEtB;;;eAGG;YACH,MAAM,CAAC,EAAE,MAAM,CAAC;YAEhB;;eAEG;YACH,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB;KACF;CACF;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,IAAI,CAAC,EAAE,6BAA6B,CAAC,IAAI,GAAG,IAAI,CAAC;IAEjD;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC;IAEvC;;OAEG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,yBAAiB,6BAA6B,CAAC;IAC7C;;OAEG;IACH,UAAiB,IAAI;QACnB,EAAE,CAAC,EAAE,MAAM,CAAC;QAEZ,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAErC,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB,UAAU,CAAC,EAAE,MAAM,CAAC;QAEpB,UAAU,CAAC,EAAE,MAAM,CAAC;QAEpB,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QAElC;;;WAGG;QACH,YAAY,CAAC,EAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAEvC,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAE7B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEtB,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAElC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE5B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B;IAED,UAAiB,IAAI,CAAC;QACpB;;WAEG;QACH,UAAiB,KAAK;YACpB,MAAM,EAAE,MAAM,CAAC;YAEf,SAAS,EAAE,MAAM,CAAC;YAElB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SAC7B;QAED;;;WAGG;QACH,UAAiB,WAAW;YAC1B,OAAO,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;YAE3C,OAAO,CAAC,EAAE,MAAM,CAAC;YAEjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAEvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SACxB;QAED,UAAiB,WAAW,CAAC;YAC3B,UAAiB,MAAM;gBACrB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;gBAE7B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;gBAErB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEd,KAAK,CAAC,EAAE,MAAM,CAAC;aAChB;SACF;KACF;CACF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,CAAC,EAAE,mBAAmB,CAAC,IAAI,GAAG,IAAI,CAAC;IAEvC;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC;IAEvC;;OAEG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,yBAAiB,mBAAmB,CAAC;IACnC;;OAEG;IACH,UAAiB,IAAI;QACnB;;WAEG;QACH,UAAU,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEnC;;WAEG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;WAEG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;IAED,UAAiB,IAAI,CAAC;QACpB;;WAEG;QACH,UAAiB,SAAS;YACxB;;;eAGG;YACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAErB;;;eAGG;YACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAExB;;eAEG;YACH,UAAU,CAAC,EAAE,MAAM,CAAC;YAEpB;;eAEG;YACH,EAAE,CAAC,EAAE,MAAM,CAAC;SACb;KACF;CACF;AAED,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAE/B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC,QAAQ,GAAG,IAAI,CAAC;IAE7C;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB;;;OAGG;IACH,EAAE,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,yBAAiB,iBAAiB,CAAC;IACjC;;;OAGG;IACH,UAAiB,QAAQ;QACvB;;WAEG;QACH,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEnB;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAErB;;WAEG;QACH,UAAU,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;KAC/C;CACF;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,iCAAiC,IAAI,iCAAiC,EAC3E,KAAK,6BAA6B,IAAI,6BAA6B,EACnE,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,+BAA+B,IAAI,+BAA+B,EACvE,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;CACH"}
+{"version":3,"file":"messages.d.mts","sourceRoot":"","sources":["../src/resources/messages.ts"],"names":[],"mappings":"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"}

package/resources/messages.d.ts

@@ -1,9 +1,12 @@
 import { APIResource } from "../core/resource.js";
-import * as WebhooksAPI from "./webhooks.js";
 import { APIPromise } from "../core/api-promise.js";
 import { RequestOptions } from "../internal/request-options.js";
 /**
- * Send and track SMS and WhatsApp messages
+ * Send a message and follow what happened to it.
+ *
+ * One endpoint sends on any channel: pass `channel: "sent"` and we pick between SMS, WhatsApp and RCS per recipient using your routing rules, or name a channel to pin it. A send is accepted asynchronously — `POST /v3/messages` returns an id, and delivery is reported through `GET /v3/messages/{id}`, its activities, or a webhook.
+ *
+ * **A message needs a sender.** What you can send, where, and at what cost is decided by the markets under **Channels** — so a recipient in a country you hold no sender for is refused here rather than queued.
  */
 export declare class Messages extends APIResource {
     /**
@@ -60,11 +63,11 @@ export interface MessageRetrieveActivitiesResponse {
     /**
      * Error information
      */
-    error?: WebhooksAPI.ErrorDetail | null;
+    error?: MessageRetrieveActivitiesResponse.Error | null;
     /**
      * Request and response metadata
      */
-    meta?: WebhooksAPI.APIMeta;
+    meta?: MessageRetrieveActivitiesResponse.Meta;
     /**
      * Indicates whether the request was successful
      */
@@ -83,6 +86,10 @@ export declare namespace MessageRetrieveActivitiesResponse {
          * The message ID these activities belong to
          */
         message_id?: string;
+        /**
+         * Pagination metadata for list responses
+         */
+        pagination?: Data.Pagination;
     }
     namespace Data {
         /**
@@ -119,6 +126,90 @@ export declare namespace MessageRetrieveActivitiesResponse {
              */
             timestamp?: string;
         }
+        /**
+         * Pagination metadata for list responses
+         */
+        interface Pagination {
+            /**
+             * @deprecated Cursor-based pagination. Never populated — see Cursors.
+             */
+            cursors?: Pagination.Cursors | null;
+            /**
+             * Whether there are more pages after this one
+             */
+            has_more?: boolean;
+            /**
+             * Current page number (1-indexed)
+             */
+            page?: number;
+            /**
+             * Number of items per page
+             */
+            page_size?: number;
+            /**
+             * Total number of items across all pages
+             */
+            total_count?: number;
+            /**
+             * Total number of pages
+             */
+            total_pages?: number;
+        }
+        namespace Pagination {
+            /**
+             * @deprecated Cursor-based pagination. Never populated — see Cursors.
+             */
+            interface Cursors {
+                /**
+                 * Cursor to fetch the next page.
+                 */
+                after?: string | null;
+                /**
+                 * Cursor to fetch the previous page.
+                 */
+                before?: string | null;
+            }
+        }
+    }
+    /**
+     * Error information
+     */
+    interface Error {
+        /**
+         * Machine-readable error code (e.g., "RESOURCE_001")
+         */
+        code?: string;
+        /**
+         * Additional validation error details (field-level errors)
+         */
+        details?: {
+            [key: string]: Array<string>;
+        } | null;
+        /**
+         * URL to documentation about this error
+         */
+        doc_url?: string | null;
+        /**
+         * Human-readable error message
+         */
+        message?: string;
+    }
+    /**
+     * Request and response metadata
+     */
+    interface Meta {
+        /**
+         * Unique identifier for this request (for tracing and support)
+         */
+        request_id?: string;
+        /**
+         * Server timestamp when the response was generated
+         */
+        timestamp?: string;
+        /**
+         * API version used for this request
+         */
+        version?: string;
     }
 }
 /**
@@ -132,11 +223,11 @@ export interface MessageRetrieveStatusResponse {
     /**
      * Error information
      */
-    error?: WebhooksAPI.ErrorDetail | null;
+    error?: MessageRetrieveStatusResponse.Error | null;
     /**
      * Request and response metadata
      */
-    meta?: WebhooksAPI.APIMeta;
+    meta?: MessageRetrieveStatusResponse.Meta;
     /**
      * Indicates whether the request was successful
      */
@@ -197,23 +288,72 @@ export declare namespace MessageRetrieveStatusResponse {
             }
         }
     }
+    /**
+     * Error information
+     */
+    interface Error {
+        /**
+         * Machine-readable error code (e.g., "RESOURCE_001")
+         */
+        code?: string;
+        /**
+         * Additional validation error details (field-level errors)
+         */
+        details?: {
+            [key: string]: Array<string>;
+        } | null;
+        /**
+         * URL to documentation about this error
+         */
+        doc_url?: string | null;
+        /**
+         * Human-readable error message
+         */
+        message?: string;
+    }
+    /**
+     * Request and response metadata
+     */
+    interface Meta {
+        /**
+         * Unique identifier for this request (for tracing and support)
+         */
+        request_id?: string;
+        /**
+         * Server timestamp when the response was generated
+         */
+        timestamp?: string;
+        /**
+         * API version used for this request
+         */
+        version?: string;
+    }
 }
 /**
  * Standard API response envelope for all v3 endpoints
  */
 export interface MessageSendResponse {
     /**
-     * Response for the multi-recipient send message endpoint
+     * The result of a multi-recipient send.
+     *
+     * Declared here rather than in the service layer. POST /v3/messages used to
+     * publish MessageSendResult — a type in Common.Services.Messaging.Contracts — so
+     * the public contract was whatever the send service happened to return, and
+     * changing that service for an internal reason changed the API. The service keeps
+     * its result; this is what a caller sees, and the mapping between them is a
+     * decision the endpoint makes.
+     *
+     * The wire is unchanged by the move: same names, same values.
      */
     data?: MessageSendResponse.Data | null;
     /**
      * Error information
      */
-    error?: WebhooksAPI.ErrorDetail | null;
+    error?: MessageSendResponse.Error | null;
     /**
      * Request and response metadata
      */
-    meta?: WebhooksAPI.APIMeta;
+    meta?: MessageSendResponse.Meta;
     /**
      * Indicates whether the request was successful
      */
@@ -221,51 +361,90 @@ export interface MessageSendResponse {
 }
 export declare namespace MessageSendResponse {
     /**
-     * Response for the multi-recipient send message endpoint
+     * The result of a multi-recipient send.
+     *
+     * Declared here rather than in the service layer. POST /v3/messages used to
+     * publish MessageSendResult — a type in Common.Services.Messaging.Contracts — so
+     * the public contract was whatever the send service happened to return, and
+     * changing that service for an internal reason changed the API. The service keeps
+     * its result; this is what a caller sees, and the mapping between them is a
+     * decision the endpoint makes.
+     *
+     * The wire is unchanged by the move: same names, same values.
      */
     interface Data {
-        /**
-         * Per-recipient message results
-         */
         recipients?: Array<Data.Recipient>;
         /**
-         * Overall request status: "QUEUED" when the batch has been accepted for delivery.
+         * Overall status — QUEUED once the batch is accepted for delivery.
          */
         status?: string;
-        /**
-         * Template ID that was used
-         */
         template_id?: string;
-        /**
-         * Template display name
-         */
         template_name?: string;
     }
     namespace Data {
         /**
-         * Per-recipient result in the send message response
+         * What one recipient of a send got, as the API reports it.
          */
         interface Recipient {
             /**
-             * Resolved template body text for this recipient's channel, or null for
-             * auto-detect
+             * Resolved template body for this recipient's channel, or null when the channel is
+             * auto-detected.
              */
             body?: string | null;
             /**
-             * Channel this message will be sent on (e.g. "sms", "whatsapp"), or null for
-             * auto-detect
+             * Channel this message will be sent on — sms, whatsapp — or null to auto-detect.
              */
             channel?: string | null;
             /**
-             * Unique message identifier for tracking this recipient's message
+             * Identifier for tracking this recipient's message.
              */
             message_id?: string;
             /**
-             * Phone number in E.164 format
+             * Phone number in E.164 format.
              */
             to?: string;
         }
     }
+    /**
+     * Error information
+     */
+    interface Error {
+        /**
+         * Machine-readable error code (e.g., "RESOURCE_001")
+         */
+        code?: string;
+        /**
+         * Additional validation error details (field-level errors)
+         */
+        details?: {
+            [key: string]: Array<string>;
+        } | null;
+        /**
+         * URL to documentation about this error
+         */
+        doc_url?: string | null;
+        /**
+         * Human-readable error message
+         */
+        message?: string;
+    }
+    /**
+     * Request and response metadata
+     */
+    interface Meta {
+        /**
+         * Unique identifier for this request (for tracing and support)
+         */
+        request_id?: string;
+        /**
+         * Server timestamp when the response was generated
+         */
+        timestamp?: string;
+        /**
+         * API version used for this request
+         */
+        version?: string;
+    }
 }
 export interface MessageRetrieveActivitiesParams {
     /**