@mobilerun/sdk 5.1.0 → 5.2.0

package/resources/webhooks/deliveries.d.ts

@@ -4,7 +4,10 @@ import { APIPromise } from "../../core/api-promise.js";
 import { RequestOptions } from "../../internal/request-options.js";
 export declare class Deliveries extends APIResource {
     /**
-     * List deliveries across all your webhooks
+     * Returns a paginated feed of webhook deliveries across all of your subscriptions,
+     * with the originating endpoint URL included on each record. Results can be
+     * filtered by delivery status (pending, success, skipped, or dead), by a `since`
+     * timestamp, and by `eventId` (exact match against the originating event id).
      *
      * @example
      * ```ts
@@ -13,7 +16,10 @@ export declare class Deliveries extends APIResource {
      */
     list(query?: DeliveryListParams | null | undefined, options?: RequestOptions): APIPromise<DeliveryListResponse>;
     /**
-     * List deliveries for a webhook
+     * Returns a paginated list of deliveries for a single webhook subscription,
+     * identified by its id. Each record reports the event, delivery status, attempt
+     * count, and the last response code or error. Results can be filtered by `eventId`
+     * (exact match against the originating event id).
      *
      * @example
      * ```ts
@@ -25,7 +31,9 @@ export declare class Deliveries extends APIResource {
      */
     listForWebhook(id: string, query?: DeliveryListForWebhookParams | null | undefined, options?: RequestOptions): APIPromise<DeliveryListForWebhookResponse>;
     /**
-     * Get a delivery with its attempts
+     * Returns a single delivery for a webhook subscription along with the full list of
+     * captured attempt records. Each attempt includes the request URL, method, headers
+     * and body, whether it was signed, and the response status, headers, and snippet.
      *
      * @example
      * ```ts
@@ -38,7 +46,10 @@ export declare class Deliveries extends APIResource {
      */
     retrieveAttempts(deliveryID: string, params: DeliveryRetrieveAttemptsParams, options?: RequestOptions): APIPromise<DeliveryRetrieveAttemptsResponse>;
     /**
-     * Aggregate delivery statistics (excludes test sends)
+     * Returns aggregate delivery statistics across all of your webhooks, including the
+     * total count, a breakdown by status (pending, success, skipped, dead), and the
+     * overall success rate. An optional `since` timestamp narrows the reporting
+     * window.
      *
      * @example
      * ```ts
@@ -57,6 +68,11 @@ export declare namespace DeliveryListResponse {
         attempts: number;
         completedAt: string | null;
         createdAt: string;
+        /**
+         * Id of the parent endpoint's creator. Null when the endpoint row is gone or its
+         * creator was never recorded.
+         */
+        createdBy: string | null;
         durationMs: number | null;
         endpointId: string;
         endpointUrl: string;
@@ -80,6 +96,11 @@ export declare namespace DeliveryListForWebhookResponse {
         attempts: number;
         completedAt: string | null;
         createdAt: string;
+        /**
+         * Id of the parent endpoint's creator. Null when the endpoint row is gone or its
+         * creator was never recorded.
+         */
+        createdBy: string | null;
         durationMs: number | null;
         endpointId: string;
         eventId: string;
@@ -101,6 +122,11 @@ export declare namespace DeliveryRetrieveAttemptsResponse {
         attempts: Array<Data.Attempt>;
         completedAt: string | null;
         createdAt: string;
+        /**
+         * Id of the parent endpoint's creator. Null when the endpoint row is gone or its
+         * creator was never recorded.
+         */
+        createdBy: string | null;
         durationMs: number | null;
         endpointId: string;
         eventId: string;
@@ -152,12 +178,20 @@ export declare namespace DeliveryStatsResponse {
     }
 }
 export interface DeliveryListParams {
+    /**
+     * Exact text match against the originating event id.
+     */
+    eventId?: string;
     page?: number;
     pageSize?: number;
     since?: string;
     status?: 'pending' | 'success' | 'skipped' | 'dead';
 }
 export interface DeliveryListForWebhookParams {
+    /**
+     * Exact text match against the originating event id.
+     */
+    eventId?: string;
     page?: number;
     pageSize?: number;
 }

package/resources/webhooks/deliveries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deliveries.d.ts","sourceRoot":"","sources":["../../src/resources/webhooks/deliveries.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deliveries.d.ts","sourceRoot":"","sources":["../../src/resources/webhooks/deliveries.ts"],"names":[],"mappings":"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"}

package/resources/webhooks/deliveries.js

@@ -6,7 +6,10 @@ const resource_1 = require("../../core/resource.js");
 const path_1 = require("../../internal/utils/path.js");
 class Deliveries extends resource_1.APIResource {
     /**
-     * List deliveries across all your webhooks
+     * Returns a paginated feed of webhook deliveries across all of your subscriptions,
+     * with the originating endpoint URL included on each record. Results can be
+     * filtered by delivery status (pending, success, skipped, or dead), by a `since`
+     * timestamp, and by `eventId` (exact match against the originating event id).
      *
      * @example
      * ```ts
@@ -17,7 +20,10 @@ class Deliveries extends resource_1.APIResource {
         return this._client.get('/webhooks/deliveries', { query, ...options });
     }
     /**
-     * List deliveries for a webhook
+     * Returns a paginated list of deliveries for a single webhook subscription,
+     * identified by its id. Each record reports the event, delivery status, attempt
+     * count, and the last response code or error. Results can be filtered by `eventId`
+     * (exact match against the originating event id).
      *
      * @example
      * ```ts
@@ -31,7 +37,9 @@ class Deliveries extends resource_1.APIResource {
         return this._client.get((0, path_1.path) `/webhooks/${id}/deliveries`, { query, ...options });
     }
     /**
-     * Get a delivery with its attempts
+     * Returns a single delivery for a webhook subscription along with the full list of
+     * captured attempt records. Each attempt includes the request URL, method, headers
+     * and body, whether it was signed, and the response status, headers, and snippet.
      *
      * @example
      * ```ts
@@ -47,7 +55,10 @@ class Deliveries extends resource_1.APIResource {
         return this._client.get((0, path_1.path) `/webhooks/${id}/deliveries/${deliveryID}`, options);
     }
     /**
-     * Aggregate delivery statistics (excludes test sends)
+     * Returns aggregate delivery statistics across all of your webhooks, including the
+     * total count, a breakdown by status (pending, success, skipped, dead), and the
+     * overall success rate. An optional `since` timestamp narrows the reporting
+     * window.
      *
      * @example
      * ```ts

package/resources/webhooks/deliveries.js.map

@@ -1 +1 @@
-{"version":3,"file":"deliveries.js","sourceRoot":"","sources":["../../src/resources/webhooks/deliveries.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAIlD,uDAAiD;AAEjD,MAAa,UAAW,SAAQ,sBAAW;IACzC;;;;;;;OAOG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;OAUG;IACH,cAAc,CACZ,EAAU,EACV,QAAyD,EAAE,EAC3D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,gBAAgB,CACd,UAAkB,EAClB,MAAsC,EACtC,OAAwB;QAExB,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,eAAe,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CACH,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF;AAtED,gCAsEC"}
+{"version":3,"file":"deliveries.js","sourceRoot":"","sources":["../../src/resources/webhooks/deliveries.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAIlD,uDAAiD;AAEjD,MAAa,UAAW,SAAQ,sBAAW;IACzC;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,cAAc,CACZ,EAAU,EACV,QAAyD,EAAE,EAC3D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CACd,UAAkB,EAClB,MAAsC,EACtC,OAAwB;QAExB,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,eAAe,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CACH,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF;AAjFD,gCAiFC"}

package/resources/webhooks/deliveries.mjs

@@ -3,7 +3,10 @@ import { APIResource } from "../../core/resource.mjs";
 import { path } from "../../internal/utils/path.mjs";
 export class Deliveries extends APIResource {
     /**
-     * List deliveries across all your webhooks
+     * Returns a paginated feed of webhook deliveries across all of your subscriptions,
+     * with the originating endpoint URL included on each record. Results can be
+     * filtered by delivery status (pending, success, skipped, or dead), by a `since`
+     * timestamp, and by `eventId` (exact match against the originating event id).
      *
      * @example
      * ```ts
@@ -14,7 +17,10 @@ export class Deliveries extends APIResource {
         return this._client.get('/webhooks/deliveries', { query, ...options });
     }
     /**
-     * List deliveries for a webhook
+     * Returns a paginated list of deliveries for a single webhook subscription,
+     * identified by its id. Each record reports the event, delivery status, attempt
+     * count, and the last response code or error. Results can be filtered by `eventId`
+     * (exact match against the originating event id).
      *
      * @example
      * ```ts
@@ -28,7 +34,9 @@ export class Deliveries extends APIResource {
         return this._client.get(path `/webhooks/${id}/deliveries`, { query, ...options });
     }
     /**
-     * Get a delivery with its attempts
+     * Returns a single delivery for a webhook subscription along with the full list of
+     * captured attempt records. Each attempt includes the request URL, method, headers
+     * and body, whether it was signed, and the response status, headers, and snippet.
      *
      * @example
      * ```ts
@@ -44,7 +52,10 @@ export class Deliveries extends APIResource {
         return this._client.get(path `/webhooks/${id}/deliveries/${deliveryID}`, options);
     }
     /**
-     * Aggregate delivery statistics (excludes test sends)
+     * Returns aggregate delivery statistics across all of your webhooks, including the
+     * total count, a breakdown by status (pending, success, skipped, dead), and the
+     * overall success rate. An optional `since` timestamp narrows the reporting
+     * window.
      *
      * @example
      * ```ts

package/resources/webhooks/deliveries.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"deliveries.mjs","sourceRoot":"","sources":["../../src/resources/webhooks/deliveries.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAIlD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC;;;;;;;OAOG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;OAUG;IACH,cAAc,CACZ,EAAU,EACV,QAAyD,EAAE,EAC3D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,gBAAgB,CACd,UAAkB,EAClB,MAAsC,EACtC,OAAwB;QAExB,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,EAAE,eAAe,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CACH,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF"}
+{"version":3,"file":"deliveries.mjs","sourceRoot":"","sources":["../../src/resources/webhooks/deliveries.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAIlD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,cAAc,CACZ,EAAU,EACV,QAAyD,EAAE,EAC3D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CACd,UAAkB,EAClB,MAAsC,EACtC,OAAwB;QAExB,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,EAAE,eAAe,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CACH,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF"}

package/resources/webhooks/webhooks.d.mts

@@ -7,7 +7,10 @@ import { RequestOptions } from "../../internal/request-options.mjs";
 export declare class Webhooks extends APIResource {
     deliveries: DeliveriesAPI.Deliveries;
     /**
-     * Register a webhook subscription
+     * Creates a webhook subscription with a delivery URL and an optional list of event
+     * types to subscribe to (defaults to all when omitted). The response includes the
+     * generated signing secret, which is returned only once at creation time and
+     * cannot be retrieved later.
      *
      * @example
      * ```ts
@@ -18,7 +21,9 @@ export declare class Webhooks extends APIResource {
      */
     create(body: WebhookCreateParams, options?: RequestOptions): APIPromise<WebhookCreateResponse>;
     /**
-     * Get a webhook subscription
+     * Returns a single webhook subscription by id, including its URL, subscribed event
+     * types, state, and system-observed delivery health. The signing secret is never
+     * included.
      *
      * @example
      * ```ts
@@ -29,7 +34,10 @@ export declare class Webhooks extends APIResource {
      */
     retrieve(id: string, options?: RequestOptions): APIPromise<WebhookRetrieveResponse>;
     /**
-     * Update a webhook subscription
+     * Updates a webhook subscription. Any combination of the subscribed event types,
+     * state (ACTIVE or DISABLED), and description may be changed, and at least one
+     * field must be supplied. Setting state to ACTIVE re-enables a subscription that
+     * was auto-blocked after sustained delivery failures.
      *
      * @example
      * ```ts
@@ -40,7 +48,10 @@ export declare class Webhooks extends APIResource {
      */
     update(id: string, body?: WebhookUpdateParams | null | undefined, options?: RequestOptions): APIPromise<WebhookUpdateResponse>;
     /**
-     * List your webhook subscriptions
+     * Returns a paginated list of your webhook subscriptions, optionally filtered by
+     * status (active, failing, blocked, or disabled) and/or by `search` (a
+     * case-insensitive substring match against the URL or description). The response
+     * also includes per-status counts across all of your subscriptions.
      *
      * @example
      * ```ts
@@ -49,7 +60,8 @@ export declare class Webhooks extends APIResource {
      */
     list(query?: WebhookListParams | null | undefined, options?: RequestOptions): APIPromise<WebhookListResponse>;
     /**
-     * Delete a webhook subscription
+     * Deletes a webhook subscription so it stops receiving deliveries. Returns 204 No
+     * Content on success.
      *
      * @example
      * ```ts
@@ -60,7 +72,9 @@ export declare class Webhooks extends APIResource {
      */
     delete(id: string, options?: RequestOptions): APIPromise<void>;
     /**
-     * List subscribable event types per source
+     * Returns the catalog of event types that webhook subscriptions can subscribe to,
+     * grouped by source. Use the returned type identifiers as the `eventTypes` values
+     * when creating or updating a webhook.
      *
      * @example
      * ```ts
@@ -69,7 +83,9 @@ export declare class Webhooks extends APIResource {
      */
     eventTypes(options?: RequestOptions): APIPromise<WebhookEventTypesResponse>;
     /**
-     * Rotate the signing secret (returned once)
+     * Generates a new signing secret for the webhook subscription and returns it once
+     * in the response. The previous secret is replaced immediately, so any signature
+     * verification on your endpoint must be updated to use the new value.
      *
      * @example
      * ```ts
@@ -80,7 +96,9 @@ export declare class Webhooks extends APIResource {
      */
     rotateSecret(id: string, options?: RequestOptions): APIPromise<WebhookRotateSecretResponse>;
     /**
-     * Send a one-shot test delivery
+     * Sends a single test payload to the webhook subscription URL to verify
+     * connectivity. The response reports whether the attempt succeeded along with the
+     * returned HTTP status code or error, if any.
      *
      * @example
      * ```ts
@@ -100,6 +118,10 @@ export declare namespace WebhookCreateResponse {
         blockedAt: string | null;
         blockedReason: string | null;
         createdAt: string;
+        /**
+         * Id of the actor who created this endpoint. Null when no creator was recorded.
+         */
+        createdBy: string | null;
         description: string | null;
         eventTypes: Array<string>;
         /**
@@ -126,6 +148,10 @@ export declare namespace WebhookRetrieveResponse {
         blockedAt: string | null;
         blockedReason: string | null;
         createdAt: string;
+        /**
+         * Id of the actor who created this endpoint. Null when no creator was recorded.
+         */
+        createdBy: string | null;
         description: string | null;
         eventTypes: Array<string>;
         /**
@@ -148,6 +174,10 @@ export declare namespace WebhookUpdateResponse {
         blockedAt: string | null;
         blockedReason: string | null;
         createdAt: string;
+        /**
+         * Id of the actor who created this endpoint. Null when no creator was recorded.
+         */
+        createdBy: string | null;
         description: string | null;
         eventTypes: Array<string>;
         /**
@@ -179,6 +209,10 @@ export declare namespace WebhookListResponse {
         blockedAt: string | null;
         blockedReason: string | null;
         createdAt: string;
+        /**
+         * Id of the actor who created this endpoint. Null when no creator was recorded.
+         */
+        createdBy: string | null;
         description: string | null;
         eventTypes: Array<string>;
         /**
@@ -197,7 +231,7 @@ export interface WebhookEventTypesResponse {
 }
 export declare namespace WebhookEventTypesResponse {
     interface Data {
-        schemaVersion: number;
+        schemaVersion: 1;
         sources: Array<Data.Source>;
     }
     namespace Data {
@@ -208,8 +242,16 @@ export declare namespace WebhookEventTypesResponse {
         namespace Source {
             interface Event {
                 description: string;
+                surfaces: Event.Surfaces;
                 type: string;
             }
+            namespace Event {
+                interface Surfaces {
+                    feed: boolean;
+                    toast: boolean;
+                    webhook: boolean;
+                }
+            }
         }
     }
 }
@@ -222,6 +264,10 @@ export declare namespace WebhookRotateSecretResponse {
         blockedAt: string | null;
         blockedReason: string | null;
         createdAt: string;
+        /**
+         * Id of the actor who created this endpoint. Null when no creator was recorded.
+         */
+        createdBy: string | null;
         description: string | null;
         eventTypes: Array<string>;
         /**
@@ -260,8 +306,20 @@ export interface WebhookUpdateParams {
     state?: 'ACTIVE' | 'DISABLED';
 }
 export interface WebhookListParams {
+    /**
+     * Only include webhooks created by this actor id. Mutually exclusive with `mine`.
+     */
+    createdBy?: string;
+    /**
+     * When true, only include webhooks created by you (not just owned by your org).
+     */
+    mine?: 'true' | 'false';
     page?: number;
     pageSize?: number;
+    /**
+     * Case-insensitive substring match against the URL or description.
+     */
+    search?: string;
     status?: 'active' | 'failing' | 'blocked' | 'disabled';
 }
 export declare namespace Webhooks {

package/resources/webhooks/webhooks.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"webhooks.d.mts","sourceRoot":"","sources":["../../src/resources/webhooks/webhooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"webhooks.d.mts","sourceRoot":"","sources":["../../src/resources/webhooks/webhooks.ts"],"names":[],"mappings":"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"}

package/resources/webhooks/webhooks.d.ts

@@ -7,7 +7,10 @@ import { RequestOptions } from "../../internal/request-options.js";
 export declare class Webhooks extends APIResource {
     deliveries: DeliveriesAPI.Deliveries;
     /**
-     * Register a webhook subscription
+     * Creates a webhook subscription with a delivery URL and an optional list of event
+     * types to subscribe to (defaults to all when omitted). The response includes the
+     * generated signing secret, which is returned only once at creation time and
+     * cannot be retrieved later.
      *
      * @example
      * ```ts
@@ -18,7 +21,9 @@ export declare class Webhooks extends APIResource {
      */
     create(body: WebhookCreateParams, options?: RequestOptions): APIPromise<WebhookCreateResponse>;
     /**
-     * Get a webhook subscription
+     * Returns a single webhook subscription by id, including its URL, subscribed event
+     * types, state, and system-observed delivery health. The signing secret is never
+     * included.
      *
      * @example
      * ```ts
@@ -29,7 +34,10 @@ export declare class Webhooks extends APIResource {
      */
     retrieve(id: string, options?: RequestOptions): APIPromise<WebhookRetrieveResponse>;
     /**
-     * Update a webhook subscription
+     * Updates a webhook subscription. Any combination of the subscribed event types,
+     * state (ACTIVE or DISABLED), and description may be changed, and at least one
+     * field must be supplied. Setting state to ACTIVE re-enables a subscription that
+     * was auto-blocked after sustained delivery failures.
      *
      * @example
      * ```ts
@@ -40,7 +48,10 @@ export declare class Webhooks extends APIResource {
      */
     update(id: string, body?: WebhookUpdateParams | null | undefined, options?: RequestOptions): APIPromise<WebhookUpdateResponse>;
     /**
-     * List your webhook subscriptions
+     * Returns a paginated list of your webhook subscriptions, optionally filtered by
+     * status (active, failing, blocked, or disabled) and/or by `search` (a
+     * case-insensitive substring match against the URL or description). The response
+     * also includes per-status counts across all of your subscriptions.
      *
      * @example
      * ```ts
@@ -49,7 +60,8 @@ export declare class Webhooks extends APIResource {
      */
     list(query?: WebhookListParams | null | undefined, options?: RequestOptions): APIPromise<WebhookListResponse>;
     /**
-     * Delete a webhook subscription
+     * Deletes a webhook subscription so it stops receiving deliveries. Returns 204 No
+     * Content on success.
      *
      * @example
      * ```ts
@@ -60,7 +72,9 @@ export declare class Webhooks extends APIResource {
      */
     delete(id: string, options?: RequestOptions): APIPromise<void>;
     /**
-     * List subscribable event types per source
+     * Returns the catalog of event types that webhook subscriptions can subscribe to,
+     * grouped by source. Use the returned type identifiers as the `eventTypes` values
+     * when creating or updating a webhook.
      *
      * @example
      * ```ts
@@ -69,7 +83,9 @@ export declare class Webhooks extends APIResource {
      */
     eventTypes(options?: RequestOptions): APIPromise<WebhookEventTypesResponse>;
     /**
-     * Rotate the signing secret (returned once)
+     * Generates a new signing secret for the webhook subscription and returns it once
+     * in the response. The previous secret is replaced immediately, so any signature
+     * verification on your endpoint must be updated to use the new value.
      *
      * @example
      * ```ts
@@ -80,7 +96,9 @@ export declare class Webhooks extends APIResource {
      */
     rotateSecret(id: string, options?: RequestOptions): APIPromise<WebhookRotateSecretResponse>;
     /**
-     * Send a one-shot test delivery
+     * Sends a single test payload to the webhook subscription URL to verify
+     * connectivity. The response reports whether the attempt succeeded along with the
+     * returned HTTP status code or error, if any.
      *
      * @example
      * ```ts
@@ -100,6 +118,10 @@ export declare namespace WebhookCreateResponse {
         blockedAt: string | null;
         blockedReason: string | null;
         createdAt: string;
+        /**
+         * Id of the actor who created this endpoint. Null when no creator was recorded.
+         */
+        createdBy: string | null;
         description: string | null;
         eventTypes: Array<string>;
         /**
@@ -126,6 +148,10 @@ export declare namespace WebhookRetrieveResponse {
         blockedAt: string | null;
         blockedReason: string | null;
         createdAt: string;
+        /**
+         * Id of the actor who created this endpoint. Null when no creator was recorded.
+         */
+        createdBy: string | null;
         description: string | null;
         eventTypes: Array<string>;
         /**
@@ -148,6 +174,10 @@ export declare namespace WebhookUpdateResponse {
         blockedAt: string | null;
         blockedReason: string | null;
         createdAt: string;
+        /**
+         * Id of the actor who created this endpoint. Null when no creator was recorded.
+         */
+        createdBy: string | null;
         description: string | null;
         eventTypes: Array<string>;
         /**
@@ -179,6 +209,10 @@ export declare namespace WebhookListResponse {
         blockedAt: string | null;
         blockedReason: string | null;
         createdAt: string;
+        /**
+         * Id of the actor who created this endpoint. Null when no creator was recorded.
+         */
+        createdBy: string | null;
         description: string | null;
         eventTypes: Array<string>;
         /**
@@ -197,7 +231,7 @@ export interface WebhookEventTypesResponse {
 }
 export declare namespace WebhookEventTypesResponse {
     interface Data {
-        schemaVersion: number;
+        schemaVersion: 1;
         sources: Array<Data.Source>;
     }
     namespace Data {
@@ -208,8 +242,16 @@ export declare namespace WebhookEventTypesResponse {
         namespace Source {
             interface Event {
                 description: string;
+                surfaces: Event.Surfaces;
                 type: string;
             }
+            namespace Event {
+                interface Surfaces {
+                    feed: boolean;
+                    toast: boolean;
+                    webhook: boolean;
+                }
+            }
         }
     }
 }
@@ -222,6 +264,10 @@ export declare namespace WebhookRotateSecretResponse {
         blockedAt: string | null;
         blockedReason: string | null;
         createdAt: string;
+        /**
+         * Id of the actor who created this endpoint. Null when no creator was recorded.
+         */
+        createdBy: string | null;
         description: string | null;
         eventTypes: Array<string>;
         /**
@@ -260,8 +306,20 @@ export interface WebhookUpdateParams {
     state?: 'ACTIVE' | 'DISABLED';
 }
 export interface WebhookListParams {
+    /**
+     * Only include webhooks created by this actor id. Mutually exclusive with `mine`.
+     */
+    createdBy?: string;
+    /**
+     * When true, only include webhooks created by you (not just owned by your org).
+     */
+    mine?: 'true' | 'false';
     page?: number;
     pageSize?: number;
+    /**
+     * Case-insensitive substring match against the URL or description.
+     */
+    search?: string;
     status?: 'active' | 'failing' | 'blocked' | 'disabled';
 }
 export declare namespace Webhooks {