@widgetic/api-sdk 1.0.27 → 1.0.29

package/dist/apis/PartnersApi.d.ts

@@ -10,14 +10,48 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { AddPartnerCreditsRequest, ConfigureAutoReloadRequest, GetPartnerCreditBalance200Response, ListPartnerPresets200Response, PartnerContract, PartnerPreset, PartnerPresetRemoval, PartnerStorageDestination, PartnerStorageRemoval, SetPartnerPresetRequest, SetPartnerStorageDestinationRequest } from '../models/index';
+import type { AddPartnerCreditsRequest, ConfigureAutoReloadRequest, GetPartnerCreditBalance200Response, ListPartnerPresets200Response, MyPartners, PartnerAnalyticsByManagedUser, PartnerAnalyticsSummary, PartnerAnalyticsTimeline, PartnerAnalyticsTopWidgets, PartnerContract, PartnerNotificationDeliveryLog, PartnerNotificationPage, PartnerNotificationSettings, PartnerNotificationSettingsChange, PartnerPreset, PartnerPresetRemoval, PartnerStorageDestination, PartnerStorageRemoval, PartnerStorageUsage, SetPartnerPresetRequest, SetPartnerStorageDestinationRequest, UpdatePartnerNotificationSettingsRequest } from '../models/index';
 export interface AddPartnerCreditsOperationRequest {
     partnerId: string;
     addPartnerCreditsRequest: AddPartnerCreditsRequest;
+    idempotencyKey?: string;
+}
+export interface CheckPartnerCreditBalancesRequest {
+    idempotencyKey?: string;
 }
 export interface ConfigureAutoReloadOperationRequest {
     partnerId: string;
     configureAutoReloadRequest: ConfigureAutoReloadRequest;
+    idempotencyKey?: string;
+}
+export interface GetPartnerAnalyticsByManagedUserRequest {
+    partnerId: string;
+    startDate?: string;
+    endDate?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface GetPartnerAnalyticsSummaryRequest {
+    partnerId: string;
+    startDate?: string;
+    endDate?: string;
+    managedUserId?: string;
+    managedUserExternalId?: string;
+}
+export interface GetPartnerAnalyticsTimelineRequest {
+    partnerId: string;
+    startDate?: string;
+    endDate?: string;
+    managedUserId?: string;
+    managedUserExternalId?: string;
+}
+export interface GetPartnerAnalyticsTopWidgetsRequest {
+    partnerId: string;
+    startDate?: string;
+    endDate?: string;
+    managedUserId?: string;
+    managedUserExternalId?: string;
+    limit?: number;
 }
 export interface GetPartnerBillingOverviewRequest {
     partnerId: string;
@@ -34,9 +68,26 @@ export interface GetPartnerCreditTransactionsRequest {
     offset?: number;
     type?: GetPartnerCreditTransactionsTypeEnum;
 }
+export interface GetPartnerNotificationSettingsRequest {
+    partnerId: string;
+}
 export interface GetPartnerStorageDestinationRequest {
     partnerId: string;
 }
+export interface GetPartnerStorageUsageRequest {
+    partnerId: string;
+    limit?: number;
+    offset?: number;
+}
+export interface ListPartnerNotificationDeliveriesRequest {
+    partnerId: string;
+    limit?: number;
+}
+export interface ListPartnerNotificationsRequest {
+    partnerId: string;
+    limit?: number;
+    before?: Date;
+}
 export interface ListPartnerPresetsRequest {
     partnerId: string;
 }
@@ -47,6 +98,10 @@ export interface RemovePartnerPresetRequest {
 export interface RemovePartnerStorageDestinationRequest {
     partnerId: string;
 }
+export interface RotatePartnerWebhookSecretRequest {
+    partnerId: string;
+    idempotencyKey?: string;
+}
 export interface SetPartnerPresetOperationRequest {
     partnerId: string;
     key: string;
@@ -56,6 +111,11 @@ export interface SetPartnerStorageDestinationOperationRequest {
     partnerId: string;
     setPartnerStorageDestinationRequest: SetPartnerStorageDestinationRequest;
 }
+export interface UpdatePartnerNotificationSettingsOperationRequest {
+    partnerId: string;
+    updatePartnerNotificationSettingsRequest: UpdatePartnerNotificationSettingsRequest;
+    idempotencyKey?: string;
+}
 export interface VerifyPartnerStorageDestinationRequest {
     partnerId: string;
 }
@@ -77,12 +137,12 @@ export declare class PartnersApi extends runtime.BaseAPI {
      * Checks all partner credit balances and triggers auto-reload where needed (Admin only)
      * Check all partner balances for auto-reload
      */
-    checkPartnerCreditBalancesRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    checkPartnerCreditBalancesRaw(requestParameters: CheckPartnerCreditBalancesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
     /**
      * Checks all partner credit balances and triggers auto-reload where needed (Admin only)
      * Check all partner balances for auto-reload
      */
-    checkPartnerCreditBalances(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    checkPartnerCreditBalances(requestParameters?: CheckPartnerCreditBalancesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
      * Configures automatic credit reload when balance falls below threshold
      * Configure auto-reload settings
@@ -93,6 +153,56 @@ export declare class PartnersApi extends runtime.BaseAPI {
      * Configure auto-reload settings
      */
     configureAutoReload(requestParameters: ConfigureAutoReloadOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Returns the partner (nearly always one) that the signed-in account administers, with the id every other partner route asks for and the standing it is in: `active`, `inactive` (not activated yet) or `suspended` (paused, with the reason Widgetic gave). A partner API key is that account\'s key, so it reads its own partner here.  An account that administers no partner is not refused: it gets `standing: not_a_partner` and an empty list, so a dashboard can tell \"this is not a partner account\" from \"something failed\".  The call stays open while the partner is paused or not yet active: that is when its dashboard has to say why.
+     * Find the partner you administer
+     */
+    getMyPartnersRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MyPartners>>;
+    /**
+     * Returns the partner (nearly always one) that the signed-in account administers, with the id every other partner route asks for and the standing it is in: `active`, `inactive` (not activated yet) or `suspended` (paused, with the reason Widgetic gave). A partner API key is that account\'s key, so it reads its own partner here.  An account that administers no partner is not refused: it gets `standing: not_a_partner` and an empty list, so a dashboard can tell \"this is not a partner account\" from \"something failed\".  The call stays open while the partner is paused or not yet active: that is when its dashboard has to say why.
+     * Find the partner you administer
+     */
+    getMyPartners(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MyPartners>;
+    /**
+     * Lists every one of your managed users with what their widgets and compositions did in a period: views, interactions and visitors, and how many widgets and compositions they have made. A managed user whose widgets were not viewed is listed too, with zeros. The most viewed come first, and `page.hasMore` says whether more follow.  Only the compositions made for a managed user count for it: file them under the user when you create them (`managedUserId` on `createComposition`), or let the user\'s editor session do it, which files everything under its user. What a visitor did with a composition that is not filed under anyone is in the summary of the whole account (`getPartnerAnalyticsSummary`) and in no managed user\'s row.  The period works as it does for `getPartnerAnalyticsSummary`. The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * What each managed user\'s widgets did
+     */
+    getPartnerAnalyticsByManagedUserRaw(requestParameters: GetPartnerAnalyticsByManagedUserRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerAnalyticsByManagedUser>>;
+    /**
+     * Lists every one of your managed users with what their widgets and compositions did in a period: views, interactions and visitors, and how many widgets and compositions they have made. A managed user whose widgets were not viewed is listed too, with zeros. The most viewed come first, and `page.hasMore` says whether more follow.  Only the compositions made for a managed user count for it: file them under the user when you create them (`managedUserId` on `createComposition`), or let the user\'s editor session do it, which files everything under its user. What a visitor did with a composition that is not filed under anyone is in the summary of the whole account (`getPartnerAnalyticsSummary`) and in no managed user\'s row.  The period works as it does for `getPartnerAnalyticsSummary`. The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * What each managed user\'s widgets did
+     */
+    getPartnerAnalyticsByManagedUser(requestParameters: GetPartnerAnalyticsByManagedUserRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerAnalyticsByManagedUser>;
+    /**
+     * Counts what the visitors of the compositions made through your account did in a period: how many times a composition was **viewed**, how many times a visitor **interacted** with one, and how many different visitors there were. It covers every composition of your account, your own and the ones made for your managed users; narrow it to one managed user with `managedUserId` or `managedUserExternalId` (not both).  The numbers come from the events the embedded widgets send while they are shown (the Widgetic embed SDK sends them by itself), counted when you ask. Only views and interactions are counted; the events that describe a visit (its start, its end, the device and the referrer) are not.  The period runs from `startDate` (included) to `endDate` (not included): the 30 days before now when you give neither, and at most 366 days. A date without a time is midnight UTC at the start of that day, so for all of October give `startDate=2026-10-01` and `endDate=2026-11-01`.  The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * What was done with a partner\'s published widgets
+     */
+    getPartnerAnalyticsSummaryRaw(requestParameters: GetPartnerAnalyticsSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerAnalyticsSummary>>;
+    /**
+     * Counts what the visitors of the compositions made through your account did in a period: how many times a composition was **viewed**, how many times a visitor **interacted** with one, and how many different visitors there were. It covers every composition of your account, your own and the ones made for your managed users; narrow it to one managed user with `managedUserId` or `managedUserExternalId` (not both).  The numbers come from the events the embedded widgets send while they are shown (the Widgetic embed SDK sends them by itself), counted when you ask. Only views and interactions are counted; the events that describe a visit (its start, its end, the device and the referrer) are not.  The period runs from `startDate` (included) to `endDate` (not included): the 30 days before now when you give neither, and at most 366 days. A date without a time is midnight UTC at the start of that day, so for all of October give `startDate=2026-10-01` and `endDate=2026-11-01`.  The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * What was done with a partner\'s published widgets
+     */
+    getPartnerAnalyticsSummary(requestParameters: GetPartnerAnalyticsSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerAnalyticsSummary>;
+    /**
+     * Counts views, interactions and visitors for each day of a period (UTC days), oldest first, for a chart. Every day of the period is in the list, also one on which nothing happened (all zeros), so the list can be drawn as it is. Narrow it to one managed user with `managedUserId` or `managedUserExternalId` (not both).  The period works as it does for `getPartnerAnalyticsSummary`; `startDate` and `endDate` are best given as dates, so that the first and the last day are whole days. The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * What was done with a partner\'s widgets, day by day
+     */
+    getPartnerAnalyticsTimelineRaw(requestParameters: GetPartnerAnalyticsTimelineRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerAnalyticsTimeline>>;
+    /**
+     * Counts views, interactions and visitors for each day of a period (UTC days), oldest first, for a chart. Every day of the period is in the list, also one on which nothing happened (all zeros), so the list can be drawn as it is. Narrow it to one managed user with `managedUserId` or `managedUserExternalId` (not both).  The period works as it does for `getPartnerAnalyticsSummary`; `startDate` and `endDate` are best given as dates, so that the first and the last day are whole days. The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * What was done with a partner\'s widgets, day by day
+     */
+    getPartnerAnalyticsTimeline(requestParameters: GetPartnerAnalyticsTimelineRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerAnalyticsTimeline>;
+    /**
+     * Lists the widgets whose compositions were viewed the most in a period, with their views, interactions, visitors and how many of their compositions were viewed. A widget that nobody viewed or used is not listed. The most viewed come first (then the most used), and at most `limit` are listed. Narrow it to one managed user with `managedUserId` or `managedUserExternalId` (not both).  The period works as it does for `getPartnerAnalyticsSummary`. The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * Which widgets were viewed the most
+     */
+    getPartnerAnalyticsTopWidgetsRaw(requestParameters: GetPartnerAnalyticsTopWidgetsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerAnalyticsTopWidgets>>;
+    /**
+     * Lists the widgets whose compositions were viewed the most in a period, with their views, interactions, visitors and how many of their compositions were viewed. A widget that nobody viewed or used is not listed. The most viewed come first (then the most used), and at most `limit` are listed. Narrow it to one managed user with `managedUserId` or `managedUserExternalId` (not both).  The period works as it does for `getPartnerAnalyticsSummary`. The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * Which widgets were viewed the most
+     */
+    getPartnerAnalyticsTopWidgets(requestParameters: GetPartnerAnalyticsTopWidgetsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerAnalyticsTopWidgets>;
     /**
      * Retrieves operational credits, the partner\'s contract terms (`partnerCustomization`, the same fields as `getPartnerContract`) and billing integration status. Internal negotiation notes are not part of it.
      * Get comprehensive partner billing overview
@@ -133,6 +243,16 @@ export declare class PartnersApi extends runtime.BaseAPI {
      * Get partner credit transaction history
      */
     getPartnerCreditTransactions(requestParameters: GetPartnerCreditTransactionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Returns who gets the emails, which events you want by email and by webhook, the address of your webhook, and whether it has a secret to sign with. The secret itself is never returned: it is shown once, when it is made. `events` lists every kind of event there is, for a settings screen.  The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * Where your notifications go
+     */
+    getPartnerNotificationSettingsRaw(requestParameters: GetPartnerNotificationSettingsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerNotificationSettings>>;
+    /**
+     * Returns who gets the emails, which events you want by email and by webhook, the address of your webhook, and whether it has a secret to sign with. The secret itself is never returned: it is shown once, when it is made. `events` lists every kind of event there is, for a settings screen.  The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * Where your notifications go
+     */
+    getPartnerNotificationSettings(requestParameters: GetPartnerNotificationSettingsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerNotificationSettings>;
     /**
      * Returns the partner\'s storage destination without its secret: the endpoint, bucket, folder and public address, the last four characters of the access key id, when the destination last passed the check, and why the latest re-check failed if it did. Responds 404 while the partner has no destination, which means the partner cannot be activated, its uploads are refused, and no editor session is made for its customers until a destination is set.  The caller must be the person who administers the partner, or a Widgetic administrator.
      * Get where a partner\'s uploaded files are stored
@@ -143,6 +263,36 @@ export declare class PartnersApi extends runtime.BaseAPI {
      * Get where a partner\'s uploaded files are stored
      */
     getPartnerStorageDestination(requestParameters: GetPartnerStorageDestinationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerStorageDestination>;
+    /**
+     * Says how many files, and how many bytes, your account keeps, in total and for each of your managed users, and how much of it is in Widgetic\'s storage and how much in your own storage destination (`setPartnerStorageDestination`). Use it to see which customers store the most, or to charge them for it.  A file is counted for a managed user when it was filed under that user: by naming `managed_user_id` or `managed_user_external_id` when you upload it (`uploadsPost`, or the metadata of a resumable upload), or because it was uploaded through that user\'s editor session, which files everything under its user. The files that are not filed under anyone (your own, and the ones uploaded without naming a managed user) are the row whose `managedUserId` is null. Deleted files are not counted. To list the files of one managed user, use the `managed_user_id` filter of `uploadsGet`.  The answer is counted when you ask, so it is always current. The groups are ordered by size, the heaviest first, and `page.hasMore` says whether more follow.  The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * What a partner\'s customers store
+     */
+    getPartnerStorageUsageRaw(requestParameters: GetPartnerStorageUsageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerStorageUsage>>;
+    /**
+     * Says how many files, and how many bytes, your account keeps, in total and for each of your managed users, and how much of it is in Widgetic\'s storage and how much in your own storage destination (`setPartnerStorageDestination`). Use it to see which customers store the most, or to charge them for it.  A file is counted for a managed user when it was filed under that user: by naming `managed_user_id` or `managed_user_external_id` when you upload it (`uploadsPost`, or the metadata of a resumable upload), or because it was uploaded through that user\'s editor session, which files everything under its user. The files that are not filed under anyone (your own, and the ones uploaded without naming a managed user) are the row whose `managedUserId` is null. Deleted files are not counted. To list the files of one managed user, use the `managed_user_id` filter of `uploadsGet`.  The answer is counted when you ask, so it is always current. The groups are ordered by size, the heaviest first, and `page.hasMore` says whether more follow.  The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * What a partner\'s customers store
+     */
+    getPartnerStorageUsage(requestParameters: GetPartnerStorageUsageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerStorageUsage>;
+    /**
+     * Lists the sends of your notifications, the newest first: each email to one address and each call to your webhook, with whether it was delivered, when it is tried again if not, how many attempts it had, and why the last one failed. Use it to find out why a webhook of yours did not receive an event.  An email counts as delivered when it was handed to the mail service; a call to your webhook counts as delivered when your endpoint answered with a 2xx status. Anything else is tried again, after 1 minute, then 5 minutes, 30 minutes, 2 hours, 6 hours, 12 hours and a day, eight attempts in all, because your address is read again at each attempt and you may have mended it. Two answers end the delivery at once: `410 Gone` and `413 Payload Too Large`.  The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * How your notifications reached you
+     */
+    listPartnerNotificationDeliveriesRaw(requestParameters: ListPartnerNotificationDeliveriesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerNotificationDeliveryLog>>;
+    /**
+     * Lists the sends of your notifications, the newest first: each email to one address and each call to your webhook, with whether it was delivered, when it is tried again if not, how many attempts it had, and why the last one failed. Use it to find out why a webhook of yours did not receive an event.  An email counts as delivered when it was handed to the mail service; a call to your webhook counts as delivered when your endpoint answered with a 2xx status. Anything else is tried again, after 1 minute, then 5 minutes, 30 minutes, 2 hours, 6 hours, 12 hours and a day, eight attempts in all, because your address is read again at each attempt and you may have mended it. Two answers end the delivery at once: `410 Gone` and `413 Payload Too Large`.  The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * How your notifications reached you
+     */
+    listPartnerNotificationDeliveries(requestParameters: ListPartnerNotificationDeliveriesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerNotificationDeliveryLog>;
+    /**
+     * Lists the notifications of a partner, the newest first: the invoices Widgetic issued and their payments, the reminders to pay them, a warning when your credits run low, and the changes to the standing of the account (activated, paused, resumed). It is the same list your dashboard shows, and each entry is what your webhook receives as `data` when you have one (`updatePartnerNotificationSettings`).  A page holds `limit` notifications (20 by default, at most 100). When there are older ones `nextBefore` is set: ask again with it as `before` to get the next page.  The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * What your partner account was told
+     */
+    listPartnerNotificationsRaw(requestParameters: ListPartnerNotificationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerNotificationPage>>;
+    /**
+     * Lists the notifications of a partner, the newest first: the invoices Widgetic issued and their payments, the reminders to pay them, a warning when your credits run low, and the changes to the standing of the account (activated, paused, resumed). It is the same list your dashboard shows, and each entry is what your webhook receives as `data` when you have one (`updatePartnerNotificationSettings`).  A page holds `limit` notifications (20 by default, at most 100). When there are older ones `nextBefore` is set: ask again with it as `before` to get the next page.  The caller must be the person who administers the partner (an API key of that account works, with the `partner:read` scope), or a Widgetic administrator.
+     * What your partner account was told
+     */
+    listPartnerNotifications(requestParameters: ListPartnerNotificationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerNotificationPage>;
     /**
      * Returns the partner\'s presets, ordered by `position` and then by `key`: the widgets it offers its managed users as starting points. The list is the same for every managed user.  Use a preset in one of two ways: - **Make a composition of it** (the content and design editor): call `createComposition` with the preset\'s   `widgetId` and the managed user. The widget itself stays yours; a composition is the user\'s own content. - **Give the user a copy to build on** (the widget creator): call `copyPresetForManagedUser`. The user gets   a widget and a canvas of their own.  Presets are not the same as the widgets Widgetic puts on every new Widgetic account. Those are chosen by Widgetic and are copied at sign-up. A preset here is yours, and is copied only when you ask.  The caller must be the person who administers the partner (an API key of that account works), or a Widgetic administrator.
      * List the widgets a partner offers as presets
@@ -173,6 +323,16 @@ export declare class PartnersApi extends runtime.BaseAPI {
      * Stop storing a partner\'s uploaded files in its own bucket
      */
     removePartnerStorageDestination(requestParameters: RemovePartnerStorageDestinationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerStorageRemoval>;
+    /**
+     * Makes a new secret to sign your webhook with, and returns it in `webhookSecret`: **keep it now, it is shown once** and cannot be read again. Use it when the secret was lost, or may have leaked.  The secret you had keeps signing beside the new one for a day, so that your receiver can switch without a call being rejected: during that day each call carries two signatures (see `updatePartnerNotificationSettings` for how they are verified). Rotating again within the day ends the overlap with the first secret.  Retry this call with the same `Idempotency-Key` if its answer was lost: the answer, secret included, is then given again, and no second secret is made.  This needs an API key with full access. The caller must be the person who administers the partner, or a Widgetic administrator.
+     * Make a new secret for your webhook
+     */
+    rotatePartnerWebhookSecretRaw(requestParameters: RotatePartnerWebhookSecretRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerNotificationSettingsChange>>;
+    /**
+     * Makes a new secret to sign your webhook with, and returns it in `webhookSecret`: **keep it now, it is shown once** and cannot be read again. Use it when the secret was lost, or may have leaked.  The secret you had keeps signing beside the new one for a day, so that your receiver can switch without a call being rejected: during that day each call carries two signatures (see `updatePartnerNotificationSettings` for how they are verified). Rotating again within the day ends the overlap with the first secret.  Retry this call with the same `Idempotency-Key` if its answer was lost: the answer, secret included, is then given again, and no second secret is made.  This needs an API key with full access. The caller must be the person who administers the partner, or a Widgetic administrator.
+     * Make a new secret for your webhook
+     */
+    rotatePartnerWebhookSecret(requestParameters: RotatePartnerWebhookSecretRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerNotificationSettingsChange>;
     /**
      * Offers one of the partner\'s own widgets as a preset under `key`. If the partner already has a preset under that key it is replaced, so sending the same request twice is safe. Saving replaces the whole preset: a `title`, `description` or `position` you leave out goes back to its default.  Keys are 1 to 64 characters: lowercase letters, digits, hyphens and underscores, the first a letter or a digit (`rating`, `quiz-3`).  The widget must belong to the partner\'s account; a widget that does not exist and one that belongs to somebody else are refused in the same way (404 `PRESET_WIDGET_NOT_FOUND`). A widget is a preset under at most one key (409 `PRESET_WIDGET_ALREADY_USED`; `details.key` says which), and an account can have at most 100 presets (409 `PRESET_LIMIT_REACHED`).  Later changes to the widget reach new copies and new compositions; copies made earlier are not touched. Deleting the widget removes its preset.
      * Make a widget a preset, or replace a preset
@@ -193,6 +353,16 @@ export declare class PartnersApi extends runtime.BaseAPI {
      * Set where a partner\'s uploaded files are stored
      */
     setPartnerStorageDestination(requestParameters: SetPartnerStorageDestinationOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerStorageDestination>;
+    /**
+     * Changes who gets the emails, which events you want by email and by webhook, and the address of your webhook. A key you leave out of the body is left as it was; send only what changes.  **Email.** `emailRecipients` is the list of addresses (at most five). While it is empty the emails about invoices go to the billing emails of your billing profile (your contact email when there are none), and the others to your contact email. The events about money and about the standing of your account are always emailed, whatever `emailEvents` says; it narrows the others.  **Webhook.** `webhookUrl` is where Widgetic sends a signed `POST` for each event, so that your own system can act on it (mark an invoice paid, warn your team that credits are low). The address must be `https` on the standard port, on a public site, and must not redirect. Setting an address when you have no secret yet makes one, and the answer carries it as `webhookSecret`: **keep it now, it is shown once**. `webhookEvents` narrows what is sent.  Each call has a JSON body, `{ \"id\": \"evt_...\", \"type\": \"invoice.paid\", \"createdAt\": \"...\", \"partnerId\": \"...\", \"data\": { ... } }` (`data` is the `data` of `PartnerNotification`), and these headers: `webhook-id` (the same as `id`, and the same on every retry), `webhook-timestamp` (seconds since 1970) and `webhook-signature` (`v1,` and a base64 HMAC-SHA256). It is the Standard Webhooks scheme, so any of its libraries verifies it. By hand: take your secret without the `whsec_` prefix, decode it from base64, and sign the text `<webhook-id>.<webhook-timestamp>.<the raw body>` with it; the header holds `v1,<base64 of the result>` (two signatures separated by a space while a rotated secret overlaps). Reject a `webhook-timestamp` that is more than five minutes old.  Answer with a 2xx status within ten seconds. Anything else is tried again, eight attempts in all over about two days (`listPartnerNotificationDeliveries` shows each). Delivery is at least once: if your answer was lost the same event arrives again with the same `id`, so drop what you have already handled by it.  Changing the settings needs an API key with full access: they decide where your notifications go. The caller must be the person who administers the partner, or a Widgetic administrator.
+     * Choose where your notifications go
+     */
+    updatePartnerNotificationSettingsRaw(requestParameters: UpdatePartnerNotificationSettingsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerNotificationSettingsChange>>;
+    /**
+     * Changes who gets the emails, which events you want by email and by webhook, and the address of your webhook. A key you leave out of the body is left as it was; send only what changes.  **Email.** `emailRecipients` is the list of addresses (at most five). While it is empty the emails about invoices go to the billing emails of your billing profile (your contact email when there are none), and the others to your contact email. The events about money and about the standing of your account are always emailed, whatever `emailEvents` says; it narrows the others.  **Webhook.** `webhookUrl` is where Widgetic sends a signed `POST` for each event, so that your own system can act on it (mark an invoice paid, warn your team that credits are low). The address must be `https` on the standard port, on a public site, and must not redirect. Setting an address when you have no secret yet makes one, and the answer carries it as `webhookSecret`: **keep it now, it is shown once**. `webhookEvents` narrows what is sent.  Each call has a JSON body, `{ \"id\": \"evt_...\", \"type\": \"invoice.paid\", \"createdAt\": \"...\", \"partnerId\": \"...\", \"data\": { ... } }` (`data` is the `data` of `PartnerNotification`), and these headers: `webhook-id` (the same as `id`, and the same on every retry), `webhook-timestamp` (seconds since 1970) and `webhook-signature` (`v1,` and a base64 HMAC-SHA256). It is the Standard Webhooks scheme, so any of its libraries verifies it. By hand: take your secret without the `whsec_` prefix, decode it from base64, and sign the text `<webhook-id>.<webhook-timestamp>.<the raw body>` with it; the header holds `v1,<base64 of the result>` (two signatures separated by a space while a rotated secret overlaps). Reject a `webhook-timestamp` that is more than five minutes old.  Answer with a 2xx status within ten seconds. Anything else is tried again, eight attempts in all over about two days (`listPartnerNotificationDeliveries` shows each). Delivery is at least once: if your answer was lost the same event arrives again with the same `id`, so drop what you have already handled by it.  Changing the settings needs an API key with full access: they decide where your notifications go. The caller must be the person who administers the partner, or a Widgetic administrator.
+     * Choose where your notifications go
+     */
+    updatePartnerNotificationSettings(requestParameters: UpdatePartnerNotificationSettingsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerNotificationSettingsChange>;
     /**
      * Runs the same check as `setPartnerStorageDestination` against the destination already saved: a test file is written, read back from the public address and deleted. Use it after rotating a key or changing a bucket policy, or when uploads are failing with 502 or 503.  The result is recorded either way. A pass refreshes `verifiedAt` and clears `lastVerificationError`; a failure answers 422 `STORAGE_DESTINATION_UNVERIFIED` and is recorded in `lastVerificationError` and `lastVerificationFailedAt`, so the destination shows what went wrong the next time it is read. A failed check does not remove the destination or stop uploads from using it.  The caller must be the person who administers the partner, or a Widgetic administrator.
      * Check that a partner\'s storage destination still works