@widgetic/api-sdk 1.0.26 → 1.0.28

package/dist/esm/apis/AdminApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime.js';
-import { AdjustPartnerCredits200ResponseFromJSON, AdjustPartnerCreditsRequestToJSON, AdjustUserCredits200ResponseFromJSON, AdjustUserCreditsRequestToJSON, AdminHealthStatusFromJSON, CleanupOrphanedInvitations200ResponseFromJSON, CleanupOrphanedInvitationsRequestToJSON, CreatePartnerRequestToJSON, PartnerActivationFromJSON, PartnerBillingReportFromJSON, PartnerDetailsFromJSON, PartnerListFromJSON, PartnerUpdateResultFromJSON, PartnerWithWarningsFromJSON, RefundPartnerCreditsRequestToJSON, UpdatePartnerRequestToJSON, UpdatePartnerStatusRequestToJSON, } from '../models/index.js';
+import { AdjustPartnerCredits200ResponseFromJSON, AdjustPartnerCreditsRequestToJSON, AdjustUserCredits200ResponseFromJSON, AdjustUserCreditsRequestToJSON, AdminHealthStatusFromJSON, CleanupOrphanedInvitations200ResponseFromJSON, CleanupOrphanedInvitationsRequestToJSON, CreatePartnerRequestToJSON, PartnerActivationFromJSON, PartnerBillingProfileSavedFromJSON, PartnerBillingProfileViewFromJSON, PartnerBillingReportFromJSON, PartnerDetailsFromJSON, PartnerEditorSessionSettingsFromJSON, PartnerListFromJSON, PartnerUpdateResultFromJSON, PartnerWithWarningsFromJSON, RecordPartnerInvoicePaymentRequestToJSON, RecordedPartnerPaymentFromJSON, RefundPartnerCreditsRequestToJSON, UpdatePartnerBillingProfileRequestToJSON, UpdatePartnerEditorSessionSettingsRequestToJSON, UpdatePartnerRequestToJSON, UpdatePartnerStatusRequestToJSON, } from '../models/index.js';
 /**
  *
  */
@@ -35,9 +35,6 @@ export class AdminApi extends runtime.BaseAPI {
             if (requestParameters['partnerId'] == null) {
                 throw new runtime.RequiredError('partnerId', 'Required parameter "partnerId" was null or undefined when calling adjustPartnerCredits().');
             }
-            if (requestParameters['idempotencyKey'] == null) {
-                throw new runtime.RequiredError('idempotencyKey', 'Required parameter "idempotencyKey" was null or undefined when calling adjustPartnerCredits().');
-            }
             if (requestParameters['adjustPartnerCreditsRequest'] == null) {
                 throw new runtime.RequiredError('adjustPartnerCreditsRequest', 'Required parameter "adjustPartnerCreditsRequest" was null or undefined when calling adjustPartnerCredits().');
             }
@@ -80,9 +77,6 @@ export class AdminApi extends runtime.BaseAPI {
      */
     adjustUserCreditsRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (requestParameters['idempotencyKey'] == null) {
-                throw new runtime.RequiredError('idempotencyKey', 'Required parameter "idempotencyKey" was null or undefined when calling adjustUserCredits().');
-            }
             if (requestParameters['adjustUserCreditsRequest'] == null) {
                 throw new runtime.RequiredError('adjustUserCreditsRequest', 'Required parameter "adjustUserCreditsRequest" was null or undefined when calling adjustUserCredits().');
             }
@@ -308,6 +302,43 @@ export class AdminApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Admin only. Reads the billing profile of a partner: the legal name, the billing emails, the billing address, the tax number and the payment terms, and what the invoices will say with them. A partner that has none saved has the defaults (the partner\'s own name, its contact email, 30 days, no address), and `gaps` says what is missing for an invoice to carry the right tax. Nothing is changed by reading it.
+     * What a partner\'s invoices are addressed with
+     */
+    getPartnerBillingProfileRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['partnerId'] == null) {
+                throw new runtime.RequiredError('partnerId', 'Required parameter "partnerId" was null or undefined when calling getPartnerBillingProfile().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("apiKeyAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const response = yield this.request({
+                path: `/admin/partners/{partnerId}/billing-profile`.replace(`{${"partnerId"}}`, encodeURIComponent(String(requestParameters['partnerId']))),
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => PartnerBillingProfileViewFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Admin only. Reads the billing profile of a partner: the legal name, the billing emails, the billing address, the tax number and the payment terms, and what the invoices will say with them. A partner that has none saved has the defaults (the partner\'s own name, its contact email, 30 days, no address), and `gaps` says what is missing for an invoice to carry the right tax. Nothing is changed by reading it.
+     * What a partner\'s invoices are addressed with
+     */
+    getPartnerBillingProfile(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getPartnerBillingProfileRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Admin only. What the partner\'s wallet did over the period, from the ledger: the totals (credits consumed and credits issued, over every row of the period however many there are), the same totals per calendar month, and, when `includeTransactions` is true, the newest ledger rows themselves. The period is the last 30 days when `startDate` and `endDate` are not given. A date that is not a date, or a start after the end, is refused with 400. The list of rows is bounded (the newest 1,000 of the period, complete); `transactionsTruncated` says when the period holds more than the list shows. The totals are never cut.
      * Get a partner\'s wallet activity for a period
@@ -391,6 +422,43 @@ export class AdminApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Admin only. Editor sessions run with the same settings for every partner (a kill switch, one allowance for every customer, no default limit on what a session may spend). This reads what has been set for ONE partner on top of that (`settings`; null means the same as everybody) and what that comes to now (`effective`). Nothing is changed by reading it.
+     * What is set for a partner\'s editor sessions
+     */
+    getPartnerEditorSessionSettingsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['partnerId'] == null) {
+                throw new runtime.RequiredError('partnerId', 'Required parameter "partnerId" was null or undefined when calling getPartnerEditorSessionSettings().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("apiKeyAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const response = yield this.request({
+                path: `/admin/partners/{partnerId}/editor-sessions`.replace(`{${"partnerId"}}`, encodeURIComponent(String(requestParameters['partnerId']))),
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => PartnerEditorSessionSettingsFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Admin only. Editor sessions run with the same settings for every partner (a kill switch, one allowance for every customer, no default limit on what a session may spend). This reads what has been set for ONE partner on top of that (`settings`; null means the same as everybody) and what that comes to now (`effective`). Nothing is changed by reading it.
+     * What is set for a partner\'s editor sessions
+     */
+    getPartnerEditorSessionSettings(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getPartnerEditorSessionSettingsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Admin only. `scope=mine` is the signed-in admin\'s widgets. `scope=all` is every account. `preset=true` keeps widgets marked for signup copy. A normal account cannot call this route.
      * List widgets for the admin console
@@ -488,15 +556,57 @@ export class AdminApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Admin only. For an invoice that was paid by bank transfer, cheque or any other way outside Stripe. It marks the invoice paid in Stripe (`paid_out_of_band`), and Stripe then reports the payment exactly as it reports a card payment: the partner\'s invoice list is brought up to date (status and paid date), the reminders stop, the partner receives its receipt, and the administrators are told the payment arrived. Nothing is written to the partner\'s invoice list here, so the list changes a moment after the answer, when Stripe\'s report arrives; an administrator never updates a status by hand. The invoice is named by its id in the partner\'s invoice list and must belong to this partner. An invoice Stripe already holds as paid is answered (`recorded: false`) and nothing happens again, so a double click or a retry is safe. An invoice Stripe holds as void, uncollectible or still a draft cannot be marked paid (409 `INVOICE_NOT_PAYABLE`), and one that was never issued through Stripe has nothing to mark (409 `INVOICE_HAS_NO_STRIPE_INVOICE`). The audit trail records who recorded it, with the optional `note` (a bank reference, say).
+     * Record a payment that arrived outside Stripe
+     */
+    recordPartnerInvoicePaymentRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['partnerId'] == null) {
+                throw new runtime.RequiredError('partnerId', 'Required parameter "partnerId" was null or undefined when calling recordPartnerInvoicePayment().');
+            }
+            if (requestParameters['invoiceId'] == null) {
+                throw new runtime.RequiredError('invoiceId', 'Required parameter "invoiceId" was null or undefined when calling recordPartnerInvoicePayment().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("apiKeyAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const response = yield this.request({
+                path: `/admin/partners/{partnerId}/invoices/{invoiceId}/record-payment`.replace(`{${"partnerId"}}`, encodeURIComponent(String(requestParameters['partnerId']))).replace(`{${"invoiceId"}}`, encodeURIComponent(String(requestParameters['invoiceId']))),
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: RecordPartnerInvoicePaymentRequestToJSON(requestParameters['recordPartnerInvoicePaymentRequest']),
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => RecordedPartnerPaymentFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Admin only. For an invoice that was paid by bank transfer, cheque or any other way outside Stripe. It marks the invoice paid in Stripe (`paid_out_of_band`), and Stripe then reports the payment exactly as it reports a card payment: the partner\'s invoice list is brought up to date (status and paid date), the reminders stop, the partner receives its receipt, and the administrators are told the payment arrived. Nothing is written to the partner\'s invoice list here, so the list changes a moment after the answer, when Stripe\'s report arrives; an administrator never updates a status by hand. The invoice is named by its id in the partner\'s invoice list and must belong to this partner. An invoice Stripe already holds as paid is answered (`recorded: false`) and nothing happens again, so a double click or a retry is safe. An invoice Stripe holds as void, uncollectible or still a draft cannot be marked paid (409 `INVOICE_NOT_PAYABLE`), and one that was never issued through Stripe has nothing to mark (409 `INVOICE_HAS_NO_STRIPE_INVOICE`). The audit trail records who recorded it, with the optional `note` (a bank reference, say).
+     * Record a payment that arrived outside Stripe
+     */
+    recordPartnerInvoicePayment(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.recordPartnerInvoicePaymentRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Admin only. Adds `amount` credits to the partner wallet as a refund. The `Idempotency-Key` header is required: a retry with the same key replays the first refund instead of issuing a second one. A refund is held to the same ceiling as a top-up: **at most $100,000 per operation** (1,000,000 credits at $0.10 per credit). A larger amount is refused with 400 and nothing is credited.
      * Credit a partner\'s wallet back with a refund
      */
     refundPartnerCreditsRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (requestParameters['idempotencyKey'] == null) {
-                throw new runtime.RequiredError('idempotencyKey', 'Required parameter "idempotencyKey" was null or undefined when calling refundPartnerCredits().');
-            }
             if (requestParameters['refundPartnerCreditsRequest'] == null) {
                 throw new runtime.RequiredError('refundPartnerCreditsRequest', 'Required parameter "refundPartnerCreditsRequest" was null or undefined when calling refundPartnerCredits().');
             }
@@ -577,6 +687,90 @@ export class AdminApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Admin only. Saves the billing profile of a partner, then brings the partner\'s Stripe customer up to date with it (name, billing email, address, tax number), so that Stripe\'s own checks of the address and the tax number show now, while the administrator is on the page, and not when the first invoice fails. A part you leave out is left as it was; `null` clears it. The profile is saved whatever Stripe says: `stripe` says what it made of it, and a tax number Stripe rejects is flagged (`taxIdRejected`) so it is corrected before an invoice is issued. The address and the tax number are what Stripe Tax uses to add tax to the partner\'s invoices.
+     * Set what a partner\'s invoices are addressed with
+     */
+    updatePartnerBillingProfileRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['partnerId'] == null) {
+                throw new runtime.RequiredError('partnerId', 'Required parameter "partnerId" was null or undefined when calling updatePartnerBillingProfile().');
+            }
+            if (requestParameters['updatePartnerBillingProfileRequest'] == null) {
+                throw new runtime.RequiredError('updatePartnerBillingProfileRequest', 'Required parameter "updatePartnerBillingProfileRequest" was null or undefined when calling updatePartnerBillingProfile().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("apiKeyAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const response = yield this.request({
+                path: `/admin/partners/{partnerId}/billing-profile`.replace(`{${"partnerId"}}`, encodeURIComponent(String(requestParameters['partnerId']))),
+                method: 'PUT',
+                headers: headerParameters,
+                query: queryParameters,
+                body: UpdatePartnerBillingProfileRequestToJSON(requestParameters['updatePartnerBillingProfileRequest']),
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => PartnerBillingProfileSavedFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Admin only. Saves the billing profile of a partner, then brings the partner\'s Stripe customer up to date with it (name, billing email, address, tax number), so that Stripe\'s own checks of the address and the tax number show now, while the administrator is on the page, and not when the first invoice fails. A part you leave out is left as it was; `null` clears it. The profile is saved whatever Stripe says: `stripe` says what it made of it, and a tax number Stripe rejects is flagged (`taxIdRejected`) so it is corrected before an invoice is issued. The address and the tax number are what Stripe Tax uses to add tax to the partner\'s invoices.
+     * Set what a partner\'s invoices are addressed with
+     */
+    updatePartnerBillingProfile(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.updatePartnerBillingProfileRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Admin only. Everybody\'s editor sessions run with the same settings; this changes them for one partner when it needs it. A setting left out stays as it is, and `null` clears it (the partner then gets what everybody gets). At least one has to be named. - `enabled: false` switches editor sessions off for this partner: no new session can be made (403   `EDITOR_SESSIONS_DISABLED_FOR_PARTNER`) and the sessions it already has stop working. It only ever narrows:   `true` is the same as `null`, and it can never switch on what the global kill switch has switched off. - `costMultiplier` is what an operation of the partner\'s customers costs their usage budget, as a multiple of   its base cost (above 0, at most 10, three decimals at most). Smaller is a larger allowance. It is the brake   on a customer\'s pace; the credits an operation spends are unchanged. - `defaultMaxCredits` is the credit limit a new session gets when the partner\'s request for it names no   `max_credits`. A request that names its own, or names `null` for none, keeps it.  The change is felt on this instance at once and on every instance within 15 seconds.
+     * Set what is different about one partner\'s editor sessions
+     */
+    updatePartnerEditorSessionSettingsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['partnerId'] == null) {
+                throw new runtime.RequiredError('partnerId', 'Required parameter "partnerId" was null or undefined when calling updatePartnerEditorSessionSettings().');
+            }
+            if (requestParameters['updatePartnerEditorSessionSettingsRequest'] == null) {
+                throw new runtime.RequiredError('updatePartnerEditorSessionSettingsRequest', 'Required parameter "updatePartnerEditorSessionSettingsRequest" was null or undefined when calling updatePartnerEditorSessionSettings().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("apiKeyAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const response = yield this.request({
+                path: `/admin/partners/{partnerId}/editor-sessions`.replace(`{${"partnerId"}}`, encodeURIComponent(String(requestParameters['partnerId']))),
+                method: 'PUT',
+                headers: headerParameters,
+                query: queryParameters,
+                body: UpdatePartnerEditorSessionSettingsRequestToJSON(requestParameters['updatePartnerEditorSessionSettingsRequest']),
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => PartnerEditorSessionSettingsFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Admin only. Everybody\'s editor sessions run with the same settings; this changes them for one partner when it needs it. A setting left out stays as it is, and `null` clears it (the partner then gets what everybody gets). At least one has to be named. - `enabled: false` switches editor sessions off for this partner: no new session can be made (403   `EDITOR_SESSIONS_DISABLED_FOR_PARTNER`) and the sessions it already has stop working. It only ever narrows:   `true` is the same as `null`, and it can never switch on what the global kill switch has switched off. - `costMultiplier` is what an operation of the partner\'s customers costs their usage budget, as a multiple of   its base cost (above 0, at most 10, three decimals at most). Smaller is a larger allowance. It is the brake   on a customer\'s pace; the credits an operation spends are unchanged. - `defaultMaxCredits` is the credit limit a new session gets when the partner\'s request for it names no   `max_credits`. A request that names its own, or names `null` for none, keeps it.  The change is felt on this instance at once and on every instance within 15 seconds.
+     * Set what is different about one partner\'s editor sessions
+     */
+    updatePartnerEditorSessionSettings(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.updatePartnerEditorSessionSettingsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Admin only. Sets the partner\'s standing (the `status` field every partner response carries). - `active` activates a new partner, or resumes a paused one: it is switched on, and a suspension\'s reason   and time are cleared. **Activating a partner that was never activated (or was deactivated) is refused with   409 `PARTNER_NOT_READY` until a contract is in force and a verified storage destination is set**   (`error.details.requirements` lists each, and `GET /admin/partners/{partnerId}/activation` reads them   without changing anything). Resuming a paused partner is never held up by that. It also records the   partner plan on the partner\'s administrator again if that was missing (a partner created before the plan   was recorded, or whose write failed); if that could not be done the partner is still reinstated and   `warnings` says so. - `inactive` switches the partner off without a reason; a suspension\'s reason and time are cleared, so   a partner moved from suspended to inactive is no longer reported as suspended. - `suspended` is the pause: it switches the partner off and records `reason` (default `Suspended by   admin`) and the time. It is manual only. An unpaid invoice is chased and reported to the administrators,   but never pauses a partner by itself.  While a partner is not `active` it is unusable, and what it published is not served: its embeds answer as if they did not exist, editor sessions are refused, its customers cannot create or generate anything, and every write or generation by its API key is refused with 403 `PARTNER_SUSPENDED` (or `PARTNER_INACTIVE`). This takes hold within 15 seconds at most, on every instance. The partner\'s own administrator can still sign in and use billing, invoices, credits, the contract and notifications. Resuming the partner restores everything, with no new token for a customer. A person who administers two partners is served while either is active, and an administrator account that also holds a subscription of its own is served on that. Sending the standing the partner already has is accepted; for `suspended` it replaces the recorded reason and time.
      * Activate, deactivate or suspend a partner

package/dist/esm/apis/AdminBillingApi.d.ts

@@ -28,18 +28,22 @@ export interface AdminBillingGrantsGetRequest {
 }
 export interface AdminBillingGrantsGrantIdApprovePostRequest {
     grantId: string;
+    idempotencyKey?: string;
 }
 export interface AdminBillingGrantsGrantIdRejectPostOperationRequest {
     grantId: string;
+    idempotencyKey?: string;
     adminBillingGrantsGrantIdRejectPostRequest?: AdminBillingGrantsGrantIdRejectPostRequest;
 }
 export interface AdminBillingGrantsPostOperationRequest {
     adminBillingGrantsPostRequest: AdminBillingGrantsPostRequest;
+    idempotencyKey?: string;
 }
 export interface AdminBillingMetricsGetRequest {
     period?: AdminBillingMetricsGetPeriodEnum;
 }
 export interface AdminBillingPlansPricesBackfillPostOperationRequest {
+    idempotencyKey?: string;
     adminBillingPlansPricesBackfillPostRequest?: AdminBillingPlansPricesBackfillPostRequest;
 }
 export interface AdminBillingPlansPricesPlanTypeBillingFrequencyPutOperationRequest {
@@ -55,28 +59,35 @@ export interface AdminBillingRefundsClawbacksGetRequest {
 }
 export interface AdminBillingRefundsPostOperationRequest {
     adminBillingRefundsPostRequest: AdminBillingRefundsPostRequest;
+    idempotencyKey?: string;
 }
 export interface AdminBillingRefundsPreviewPostOperationRequest {
     adminBillingRefundsPreviewPostRequest: AdminBillingRefundsPreviewPostRequest;
 }
 export interface AdminBillingSubscriptionsSubjectIdCancelAtPeriodEndPostRequest {
     subjectId: string;
+    idempotencyKey?: string;
 }
 export interface AdminBillingSubscriptionsSubjectIdCancelPostOperationRequest {
     subjectId: string;
     adminBillingSubscriptionsSubjectIdCancelPostRequest: AdminBillingSubscriptionsSubjectIdCancelPostRequest;
+    idempotencyKey?: string;
 }
 export interface AdminBillingSubscriptionsSubjectIdDeleteAccountPostRequest {
     subjectId: string;
+    idempotencyKey?: string;
 }
 export interface AdminBillingSubscriptionsSubjectIdSuspendPostRequest {
     subjectId: string;
+    idempotencyKey?: string;
 }
 export interface AdminBillingSubscriptionsSubjectIdTransferOwnershipPostRequest {
     subjectId: string;
+    idempotencyKey?: string;
 }
 export interface AdminBillingSubscriptionsSubjectIdUnsuspendPostRequest {
     subjectId: string;
+    idempotencyKey?: string;
 }
 export interface AdminBillingTeamsSearchGetRequest {
     q?: string;
@@ -84,7 +95,7 @@ export interface AdminBillingTeamsSearchGetRequest {
 }
 export interface IssuePartnerInvoiceOperationRequest {
     partnerId: string;
-    idempotencyKey: string;
+    idempotencyKey?: string;
     issuePartnerInvoiceRequest?: IssuePartnerInvoiceRequest;
 }
 /**
@@ -308,12 +319,12 @@ export declare class AdminBillingApi extends runtime.BaseAPI {
      */
     adminBillingTeamsSearchGet(requestParameters?: AdminBillingTeamsSearchGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
-     * Issues a Stripe invoice to a partner and has Stripe email it to the partner\'s contact address. The amount is the contract price on the partner\'s customization unless `amountUsd` is given; the partner must have a contract either way.  The invoice is recorded in the partner\'s invoice list (`getInvoicesByPartnerId`) as `open`, and marked `paid` when Stripe reports the payment. Voiding an invoice or writing it off in Stripe is not mirrored yet: the list keeps showing it as `open` until that is done by hand.  An `Idempotency-Key` is required, and it is what makes a retry safe: the same key with the same body returns the invoice already issued, the same key with a different body is refused with 422, and a duplicate that arrives while the first is still running is refused with 409. Use one key per invoice you mean to send, and a new key for the next one.  Every invoice issued is written to the billing audit log under the administrator who issued it.
+     * Issues a Stripe invoice to a partner and has Stripe email it to the partner\'s billing address (the first billing email on its billing profile, else its contact email). The price is the contract price on the partner\'s customization unless `amountUsd` is given; the partner must have a contract either way. The invoice is addressed to the legal name on the billing profile (else the partner\'s name) and is due after the payment terms on it (30 days until they are set) unless `daysUntilDue` says otherwise.  TAX. Stripe Tax works the tax out from the billing address on the profile, and a valid tax ID on it turns the tax of a business abroad into the reverse charge. The response says what the price, the tax and the total are. When Stripe cannot place the partner, the invoice is still issued, without tax, and `taxNote` says so. A tax ID Stripe does not accept is refused with 422 `TAX_ID_INVALID` before anything is issued.  The invoice is recorded in the partner\'s invoice list (`getInvoicesByPartnerId`) as `open`, and follows what Stripe reports from then on: `failed` (with the reason) when a payment fails, `paid` when it is paid (also when an administrator records a payment received outside Stripe), `void` when it is voided and `uncollectible` when it is written off. Nobody has to update a status by hand.  An `Idempotency-Key` is required, and it is what makes a retry safe: the same key with the same body returns the invoice already issued, the same key with a different body is refused with 422, and a duplicate that arrives while the first is still running is refused with 409. Use one key per invoice you mean to send, and a new key for the next one.  Every invoice issued is written to the billing audit log under the administrator who issued it.
      * Issue a contract invoice to a partner
      */
     issuePartnerInvoiceRaw(requestParameters: IssuePartnerInvoiceOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<IssuedPartnerInvoice>>;
     /**
-     * Issues a Stripe invoice to a partner and has Stripe email it to the partner\'s contact address. The amount is the contract price on the partner\'s customization unless `amountUsd` is given; the partner must have a contract either way.  The invoice is recorded in the partner\'s invoice list (`getInvoicesByPartnerId`) as `open`, and marked `paid` when Stripe reports the payment. Voiding an invoice or writing it off in Stripe is not mirrored yet: the list keeps showing it as `open` until that is done by hand.  An `Idempotency-Key` is required, and it is what makes a retry safe: the same key with the same body returns the invoice already issued, the same key with a different body is refused with 422, and a duplicate that arrives while the first is still running is refused with 409. Use one key per invoice you mean to send, and a new key for the next one.  Every invoice issued is written to the billing audit log under the administrator who issued it.
+     * Issues a Stripe invoice to a partner and has Stripe email it to the partner\'s billing address (the first billing email on its billing profile, else its contact email). The price is the contract price on the partner\'s customization unless `amountUsd` is given; the partner must have a contract either way. The invoice is addressed to the legal name on the billing profile (else the partner\'s name) and is due after the payment terms on it (30 days until they are set) unless `daysUntilDue` says otherwise.  TAX. Stripe Tax works the tax out from the billing address on the profile, and a valid tax ID on it turns the tax of a business abroad into the reverse charge. The response says what the price, the tax and the total are. When Stripe cannot place the partner, the invoice is still issued, without tax, and `taxNote` says so. A tax ID Stripe does not accept is refused with 422 `TAX_ID_INVALID` before anything is issued.  The invoice is recorded in the partner\'s invoice list (`getInvoicesByPartnerId`) as `open`, and follows what Stripe reports from then on: `failed` (with the reason) when a payment fails, `paid` when it is paid (also when an administrator records a payment received outside Stripe), `void` when it is voided and `uncollectible` when it is written off. Nobody has to update a status by hand.  An `Idempotency-Key` is required, and it is what makes a retry safe: the same key with the same body returns the invoice already issued, the same key with a different body is refused with 422, and a duplicate that arrives while the first is still running is refused with 409. Use one key per invoice you mean to send, and a new key for the next one.  Every invoice issued is written to the billing audit log under the administrator who issued it.
      * Issue a contract invoice to a partner
      */
     issuePartnerInvoice(requestParameters: IssuePartnerInvoiceOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<IssuedPartnerInvoice>;

package/dist/esm/apis/AdminBillingApi.js

@@ -282,6 +282,9 @@ export class AdminBillingApi extends runtime.BaseAPI {
             }
             const queryParameters = {};
             const headerParameters = {};
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -317,6 +320,9 @@ export class AdminBillingApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -353,6 +359,9 @@ export class AdminBillingApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -422,6 +431,9 @@ export class AdminBillingApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -616,6 +628,9 @@ export class AdminBillingApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -691,6 +706,9 @@ export class AdminBillingApi extends runtime.BaseAPI {
             }
             const queryParameters = {};
             const headerParameters = {};
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -729,6 +747,9 @@ export class AdminBillingApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -764,6 +785,9 @@ export class AdminBillingApi extends runtime.BaseAPI {
             }
             const queryParameters = {};
             const headerParameters = {};
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -798,6 +822,9 @@ export class AdminBillingApi extends runtime.BaseAPI {
             }
             const queryParameters = {};
             const headerParameters = {};
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -832,6 +859,9 @@ export class AdminBillingApi extends runtime.BaseAPI {
             }
             const queryParameters = {};
             const headerParameters = {};
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -866,6 +896,9 @@ export class AdminBillingApi extends runtime.BaseAPI {
             }
             const queryParameters = {};
             const headerParameters = {};
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -928,7 +961,7 @@ export class AdminBillingApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Issues a Stripe invoice to a partner and has Stripe email it to the partner\'s contact address. The amount is the contract price on the partner\'s customization unless `amountUsd` is given; the partner must have a contract either way.  The invoice is recorded in the partner\'s invoice list (`getInvoicesByPartnerId`) as `open`, and marked `paid` when Stripe reports the payment. Voiding an invoice or writing it off in Stripe is not mirrored yet: the list keeps showing it as `open` until that is done by hand.  An `Idempotency-Key` is required, and it is what makes a retry safe: the same key with the same body returns the invoice already issued, the same key with a different body is refused with 422, and a duplicate that arrives while the first is still running is refused with 409. Use one key per invoice you mean to send, and a new key for the next one.  Every invoice issued is written to the billing audit log under the administrator who issued it.
+     * Issues a Stripe invoice to a partner and has Stripe email it to the partner\'s billing address (the first billing email on its billing profile, else its contact email). The price is the contract price on the partner\'s customization unless `amountUsd` is given; the partner must have a contract either way. The invoice is addressed to the legal name on the billing profile (else the partner\'s name) and is due after the payment terms on it (30 days until they are set) unless `daysUntilDue` says otherwise.  TAX. Stripe Tax works the tax out from the billing address on the profile, and a valid tax ID on it turns the tax of a business abroad into the reverse charge. The response says what the price, the tax and the total are. When Stripe cannot place the partner, the invoice is still issued, without tax, and `taxNote` says so. A tax ID Stripe does not accept is refused with 422 `TAX_ID_INVALID` before anything is issued.  The invoice is recorded in the partner\'s invoice list (`getInvoicesByPartnerId`) as `open`, and follows what Stripe reports from then on: `failed` (with the reason) when a payment fails, `paid` when it is paid (also when an administrator records a payment received outside Stripe), `void` when it is voided and `uncollectible` when it is written off. Nobody has to update a status by hand.  An `Idempotency-Key` is required, and it is what makes a retry safe: the same key with the same body returns the invoice already issued, the same key with a different body is refused with 422, and a duplicate that arrives while the first is still running is refused with 409. Use one key per invoice you mean to send, and a new key for the next one.  Every invoice issued is written to the billing audit log under the administrator who issued it.
      * Issue a contract invoice to a partner
      */
     issuePartnerInvoiceRaw(requestParameters, initOverrides) {
@@ -936,9 +969,6 @@ export class AdminBillingApi extends runtime.BaseAPI {
             if (requestParameters['partnerId'] == null) {
                 throw new runtime.RequiredError('partnerId', 'Required parameter "partnerId" was null or undefined when calling issuePartnerInvoice().');
             }
-            if (requestParameters['idempotencyKey'] == null) {
-                throw new runtime.RequiredError('idempotencyKey', 'Required parameter "idempotencyKey" was null or undefined when calling issuePartnerInvoice().');
-            }
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
@@ -963,7 +993,7 @@ export class AdminBillingApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Issues a Stripe invoice to a partner and has Stripe email it to the partner\'s contact address. The amount is the contract price on the partner\'s customization unless `amountUsd` is given; the partner must have a contract either way.  The invoice is recorded in the partner\'s invoice list (`getInvoicesByPartnerId`) as `open`, and marked `paid` when Stripe reports the payment. Voiding an invoice or writing it off in Stripe is not mirrored yet: the list keeps showing it as `open` until that is done by hand.  An `Idempotency-Key` is required, and it is what makes a retry safe: the same key with the same body returns the invoice already issued, the same key with a different body is refused with 422, and a duplicate that arrives while the first is still running is refused with 409. Use one key per invoice you mean to send, and a new key for the next one.  Every invoice issued is written to the billing audit log under the administrator who issued it.
+     * Issues a Stripe invoice to a partner and has Stripe email it to the partner\'s billing address (the first billing email on its billing profile, else its contact email). The price is the contract price on the partner\'s customization unless `amountUsd` is given; the partner must have a contract either way. The invoice is addressed to the legal name on the billing profile (else the partner\'s name) and is due after the payment terms on it (30 days until they are set) unless `daysUntilDue` says otherwise.  TAX. Stripe Tax works the tax out from the billing address on the profile, and a valid tax ID on it turns the tax of a business abroad into the reverse charge. The response says what the price, the tax and the total are. When Stripe cannot place the partner, the invoice is still issued, without tax, and `taxNote` says so. A tax ID Stripe does not accept is refused with 422 `TAX_ID_INVALID` before anything is issued.  The invoice is recorded in the partner\'s invoice list (`getInvoicesByPartnerId`) as `open`, and follows what Stripe reports from then on: `failed` (with the reason) when a payment fails, `paid` when it is paid (also when an administrator records a payment received outside Stripe), `void` when it is voided and `uncollectible` when it is written off. Nobody has to update a status by hand.  An `Idempotency-Key` is required, and it is what makes a retry safe: the same key with the same body returns the invoice already issued, the same key with a different body is refused with 422, and a duplicate that arrives while the first is still running is refused with 409. Use one key per invoice you mean to send, and a new key for the next one.  Every invoice issued is written to the billing audit log under the administrator who issued it.
      * Issue a contract invoice to a partner
      */
     issuePartnerInvoice(requestParameters, initOverrides) {

package/dist/esm/apis/AgentApi.d.ts

@@ -13,9 +13,11 @@ import * as runtime from '../runtime';
 import type { AgentCodeModifyPost202Response, AgentComponentsComponentIdTasksCleanupPost200Response, AgentDesignResolvePost200Response, AgentDesignResolvePostRequest, AgentModelsGet200Response, AgentShapeRecognizePost200Response, AgentShapeRecognizePostRequest, AgentTasksIdCancelPost200Response, AgentWidgetBuilderPublishWidgetIdPost200Response, AgentWidgetBuilderPublishWidgetIdPostRequest, AgentWidgetBuilderRepoHeadWidgetIdGet200Response, CodeGenerationStatusResponse, GenerateCodeRequest, InitRepoRequest, ModifyCodeRequest, PreviewWidgetVersion200Response, RepositoryResponse } from '../models/index';
 export interface AgentCodeGeneratePostRequest {
     generateCodeRequest: GenerateCodeRequest;
+    idempotencyKey?: string;
 }
 export interface AgentCodeModifyPostRequest {
     modifyCodeRequest: ModifyCodeRequest;
+    idempotencyKey?: string;
 }
 export interface AgentCodeStatusTaskIdGetRequest {
     taskId: string;
@@ -28,6 +30,7 @@ export interface AgentDesignResolvePostOperationRequest {
 }
 export interface AgentRepositoriesPostRequest {
     initRepoRequest: InitRepoRequest;
+    idempotencyKey?: string;
 }
 export interface AgentRepositoriesRepoIdGetRequest {
     repoId: string;
@@ -41,6 +44,7 @@ export interface AgentTasksIdCancelPostRequest {
 export interface AgentWidgetBuilderPublishWidgetIdPostOperationRequest {
     widgetId: string;
     agentWidgetBuilderPublishWidgetIdPostRequest: AgentWidgetBuilderPublishWidgetIdPostRequest;
+    idempotencyKey?: string;
 }
 export interface AgentWidgetBuilderRepoHeadWidgetIdGetRequest {
     widgetId: string;
@@ -144,12 +148,12 @@ export declare class AgentApi extends runtime.BaseAPI {
      */
     agentShapeRecognizePost(requestParameters: AgentShapeRecognizePostOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentShapeRecognizePost200Response>;
     /**
-     * Cancels an in-progress or queued code generation task.  The cancellation behavior depends on the current state of the task:  - For queued tasks: Immediately removes the task from the queue and notifies the client - For in-progress tasks: Sets a cancellation flag that the background process checks   at strategic checkpoints, allowing the current operation to complete safely - For completed/failed/canceled tasks: Returns success with a message indicating   the task is already in a terminal state  This endpoint ensures data integrity by using a non-destructive cancellation approach that prevents repository corruption from abrupt termination.
+     * Cancels an in-progress or queued code generation task.  The cancellation behavior depends on the current state of the task:  - For queued tasks: Immediately removes the task from the queue and notifies the client - For in-progress tasks: Sets a cancellation flag that the background process checks   at strategic checkpoints, allowing the current operation to complete safely - For completed/failed/canceled tasks: Returns success with a message indicating   the task is already in a terminal state  This endpoint ensures data integrity by using a non-destructive cancellation approach that prevents repository corruption from abrupt termination.  The request to the model is aborted at once, and the run ends at its next checkpoint without building a preview or saving anything. The credit of the generation comes back when the run is stopped before the model began to write; once the answer has begun to stream, the credit is kept. Same behaviour as `POST /operations/{id}/cancel`.
      * Cancel a running or queued code generation task
      */
     agentTasksIdCancelPostRaw(requestParameters: AgentTasksIdCancelPostRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentTasksIdCancelPost200Response>>;
     /**
-     * Cancels an in-progress or queued code generation task.  The cancellation behavior depends on the current state of the task:  - For queued tasks: Immediately removes the task from the queue and notifies the client - For in-progress tasks: Sets a cancellation flag that the background process checks   at strategic checkpoints, allowing the current operation to complete safely - For completed/failed/canceled tasks: Returns success with a message indicating   the task is already in a terminal state  This endpoint ensures data integrity by using a non-destructive cancellation approach that prevents repository corruption from abrupt termination.
+     * Cancels an in-progress or queued code generation task.  The cancellation behavior depends on the current state of the task:  - For queued tasks: Immediately removes the task from the queue and notifies the client - For in-progress tasks: Sets a cancellation flag that the background process checks   at strategic checkpoints, allowing the current operation to complete safely - For completed/failed/canceled tasks: Returns success with a message indicating   the task is already in a terminal state  This endpoint ensures data integrity by using a non-destructive cancellation approach that prevents repository corruption from abrupt termination.  The request to the model is aborted at once, and the run ends at its next checkpoint without building a preview or saving anything. The credit of the generation comes back when the run is stopped before the model began to write; once the answer has begun to stream, the credit is kept. Same behaviour as `POST /operations/{id}/cancel`.
      * Cancel a running or queued code generation task
      */
     agentTasksIdCancelPost(requestParameters: AgentTasksIdCancelPostRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentTasksIdCancelPost200Response>;

package/dist/esm/apis/AgentApi.js

@@ -38,6 +38,9 @@ export class AgentApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -76,6 +79,9 @@ export class AgentApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -255,6 +261,9 @@ export class AgentApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -359,7 +368,7 @@ export class AgentApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Cancels an in-progress or queued code generation task.  The cancellation behavior depends on the current state of the task:  - For queued tasks: Immediately removes the task from the queue and notifies the client - For in-progress tasks: Sets a cancellation flag that the background process checks   at strategic checkpoints, allowing the current operation to complete safely - For completed/failed/canceled tasks: Returns success with a message indicating   the task is already in a terminal state  This endpoint ensures data integrity by using a non-destructive cancellation approach that prevents repository corruption from abrupt termination.
+     * Cancels an in-progress or queued code generation task.  The cancellation behavior depends on the current state of the task:  - For queued tasks: Immediately removes the task from the queue and notifies the client - For in-progress tasks: Sets a cancellation flag that the background process checks   at strategic checkpoints, allowing the current operation to complete safely - For completed/failed/canceled tasks: Returns success with a message indicating   the task is already in a terminal state  This endpoint ensures data integrity by using a non-destructive cancellation approach that prevents repository corruption from abrupt termination.  The request to the model is aborted at once, and the run ends at its next checkpoint without building a preview or saving anything. The credit of the generation comes back when the run is stopped before the model began to write; once the answer has begun to stream, the credit is kept. Same behaviour as `POST /operations/{id}/cancel`.
      * Cancel a running or queued code generation task
      */
     agentTasksIdCancelPostRaw(requestParameters, initOverrides) {
@@ -386,7 +395,7 @@ export class AgentApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Cancels an in-progress or queued code generation task.  The cancellation behavior depends on the current state of the task:  - For queued tasks: Immediately removes the task from the queue and notifies the client - For in-progress tasks: Sets a cancellation flag that the background process checks   at strategic checkpoints, allowing the current operation to complete safely - For completed/failed/canceled tasks: Returns success with a message indicating   the task is already in a terminal state  This endpoint ensures data integrity by using a non-destructive cancellation approach that prevents repository corruption from abrupt termination.
+     * Cancels an in-progress or queued code generation task.  The cancellation behavior depends on the current state of the task:  - For queued tasks: Immediately removes the task from the queue and notifies the client - For in-progress tasks: Sets a cancellation flag that the background process checks   at strategic checkpoints, allowing the current operation to complete safely - For completed/failed/canceled tasks: Returns success with a message indicating   the task is already in a terminal state  This endpoint ensures data integrity by using a non-destructive cancellation approach that prevents repository corruption from abrupt termination.  The request to the model is aborted at once, and the run ends at its next checkpoint without building a preview or saving anything. The credit of the generation comes back when the run is stopped before the model began to write; once the answer has begun to stream, the credit is kept. Same behaviour as `POST /operations/{id}/cancel`.
      * Cancel a running or queued code generation task
      */
     agentTasksIdCancelPost(requestParameters, initOverrides) {
@@ -410,6 +419,9 @@ export class AgentApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);