@stigg/typescript 0.1.0-beta.2 → 0.1.0-beta.21

package/resources/v1/customers/customers.d.mts

@@ -2,7 +2,7 @@ import { APIResource } from "../../../core/resource.mjs";
 import * as IntegrationsAPI from "./integrations.mjs";
 import { IntegrationLinkParams, IntegrationListParams, IntegrationListResponse, IntegrationListResponsesMyCursorIDPage, IntegrationRetrieveParams, IntegrationUnlinkParams, IntegrationUpdateParams, Integrations } from "./integrations.mjs";
 import * as PaymentMethodAPI from "./payment-method.mjs";
-import { PaymentMethod, PaymentMethodAttachParams } from "./payment-method.mjs";
+import { PaymentMethod, PaymentMethodAttachParams, PaymentMethodDetachParams } from "./payment-method.mjs";
 import * as PromotionalEntitlementsAPI from "./promotional-entitlements.mjs";
 import { PromotionalEntitlementCreateParams, PromotionalEntitlementCreateResponse, PromotionalEntitlementListParams, PromotionalEntitlementListResponse, PromotionalEntitlementListResponsesMyCursorIDPage, PromotionalEntitlementRevokeParams, PromotionalEntitlementRevokeResponse, PromotionalEntitlements } from "./promotional-entitlements.mjs";
 import { APIPromise } from "../../../core/api-promise.mjs";
@@ -15,22 +15,51 @@ export declare class Customers extends APIResource {
     /**
      * Retrieves a customer by their unique identifier, including billing information
      * and subscription status.
+     *
+     * @example
+     * ```ts
+     * const customerResponse = await client.v1.customers.retrieve(
+     *   'x',
+     * );
+     * ```
      */
-    retrieve(id: string, options?: RequestOptions): APIPromise<CustomerResponse>;
+    retrieve(id: string, params?: CustomerRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<CustomerResponse>;
     /**
      * Updates an existing customer's properties such as name, email, and billing
      * information.
+     *
+     * @example
+     * ```ts
+     * const customerResponse = await client.v1.customers.update(
+     *   'x',
+     * );
+     * ```
      */
-    update(id: string, body: CustomerUpdateParams, options?: RequestOptions): APIPromise<CustomerResponse>;
+    update(id: string, params: CustomerUpdateParams, options?: RequestOptions): APIPromise<CustomerResponse>;
     /**
      * Retrieves a paginated list of customers in the environment.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const customerListResponse of client.v1.customers.list()) {
+     *   // ...
+     * }
+     * ```
      */
-    list(query?: CustomerListParams | null | undefined, options?: RequestOptions): PagePromise<CustomerListResponsesMyCursorIDPage, CustomerListResponse>;
+    list(params?: CustomerListParams | null | undefined, options?: RequestOptions): PagePromise<CustomerListResponsesMyCursorIDPage, CustomerListResponse>;
     /**
      * Archives a customer, preventing new subscriptions. Optionally cancels existing
      * subscriptions.
+     *
+     * @example
+     * ```ts
+     * const customerResponse = await client.v1.customers.archive(
+     *   'x',
+     * );
+     * ```
      */
-    archive(id: string, options?: RequestOptions): APIPromise<CustomerResponse>;
+    archive(id: string, params?: CustomerArchiveParams | null | undefined, options?: RequestOptions): APIPromise<CustomerResponse>;
     /**
      * Checks a single entitlement (feature or credit) for a customer or resource.
      * Supports `requestedUsage` and `requestedValues` to evaluate against limits or
@@ -40,22 +69,58 @@ export declare class Customers extends APIResource {
      * mechanisms, and low-latency guarantees. It is not recommended for hot-path
      * entitlement checks. For production use, consider using the Stigg Node Server SDK
      * with caching or the Sidecar for low-latency cached responses.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v1.customers.checkEntitlement(
+     *   'x',
+     * );
+     * ```
      */
-    checkEntitlement(id: string, query?: CustomerCheckEntitlementParams | null | undefined, options?: RequestOptions): APIPromise<CustomerCheckEntitlementResponse>;
+    checkEntitlement(id: string, params?: CustomerCheckEntitlementParams | null | undefined, options?: RequestOptions): APIPromise<CustomerCheckEntitlementResponse>;
     /**
      * Imports multiple customers in bulk. Used for migrating customer data from
      * external systems.
-     */
-    import(body: CustomerImportParams, options?: RequestOptions): APIPromise<CustomerImportResponse>;
+     *
+     * @example
+     * ```ts
+     * const response = await client.v1.customers.import({
+     *   customers: [
+     *     {
+     *       id: 'id',
+     *       email: 'dev@stainless.com',
+     *       name: 'name',
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    import(params: CustomerImportParams, options?: RequestOptions): APIPromise<CustomerImportResponse>;
     /**
      * Retrieves a paginated list of resources within the same customer.
-     */
-    listResources(id: string, query?: CustomerListResourcesParams | null | undefined, options?: RequestOptions): PagePromise<CustomerListResourcesResponsesMyCursorIDPage, CustomerListResourcesResponse>;
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const customerListResourcesResponse of client.v1.customers.listResources(
+     *   'x',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    listResources(id: string, params?: CustomerListResourcesParams | null | undefined, options?: RequestOptions): PagePromise<CustomerListResourcesResponsesMyCursorIDPage, CustomerListResourcesResponse>;
     /**
      * Creates a new customer and optionally provisions an initial subscription in a
      * single operation.
+     *
+     * @example
+     * ```ts
+     * const customerResponse =
+     *   await client.v1.customers.provision({ id: 'id' });
+     * ```
      */
-    provision(body: CustomerProvisionParams, options?: RequestOptions): APIPromise<CustomerResponse>;
+    provision(params: CustomerProvisionParams, options?: RequestOptions): APIPromise<CustomerResponse>;
     /**
      * Retrieves the effective entitlements for a customer or resource, including
      * feature and credit entitlements.
@@ -64,12 +129,24 @@ export declare class Customers extends APIResource {
      * mechanisms, and low-latency guarantees. It is not recommended for hot-path
      * entitlement checks. For production use, consider using the Stigg Node Server SDK
      * with caching or the Sidecar for low-latency cached responses.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1.customers.retrieveEntitlements('x');
+     * ```
      */
-    retrieveEntitlements(id: string, query?: CustomerRetrieveEntitlementsParams | null | undefined, options?: RequestOptions): APIPromise<CustomerRetrieveEntitlementsResponse>;
+    retrieveEntitlements(id: string, params?: CustomerRetrieveEntitlementsParams | null | undefined, options?: RequestOptions): APIPromise<CustomerRetrieveEntitlementsResponse>;
     /**
      * Restores an archived customer, allowing them to create new subscriptions again.
+     *
+     * @example
+     * ```ts
+     * const customerResponse =
+     *   await client.v1.customers.unarchive('x');
+     * ```
      */
-    unarchive(id: string, options?: RequestOptions): APIPromise<CustomerResponse>;
+    unarchive(id: string, params?: CustomerUnarchiveParams | null | undefined, options?: RequestOptions): APIPromise<CustomerResponse>;
 }
 export type CustomerListResponsesMyCursorIDPage = MyCursorIDPage<CustomerListResponse>;
 export type CustomerListResourcesResponsesMyCursorIDPage = MyCursorIDPage<CustomerListResourcesResponse>;
@@ -98,7 +175,7 @@ export declare namespace CustomerIntegrationResponse {
         /**
          * The vendor identifier of integration
          */
-        vendorIdentifier: 'AUTH0' | 'ZUORA' | 'STRIPE' | 'HUBSPOT' | 'AWS_MARKETPLACE' | 'SNOWFLAKE' | 'SALESFORCE' | 'BIG_QUERY' | 'OPEN_FGA' | 'APP_STORE';
+        vendorIdentifier: 'AUTH0' | 'ZUORA' | 'STRIPE' | 'HUBSPOT' | 'AWS_MARKETPLACE' | 'SNOWFLAKE' | 'SALESFORCE' | 'BIG_QUERY' | 'OPEN_FGA' | 'APP_STORE' | 'RECEIVED' | 'PREQUEL';
         /**
          * Price billing sync revision data containing billing ID, link URL, and price
          * group package billing ID
@@ -266,7 +343,7 @@ export declare namespace CustomerResponse {
             /**
              * The vendor identifier of integration
              */
-            vendorIdentifier: 'AUTH0' | 'ZUORA' | 'STRIPE' | 'HUBSPOT' | 'AWS_MARKETPLACE' | 'SNOWFLAKE' | 'SALESFORCE' | 'BIG_QUERY' | 'OPEN_FGA' | 'APP_STORE';
+            vendorIdentifier: 'AUTH0' | 'ZUORA' | 'STRIPE' | 'HUBSPOT' | 'AWS_MARKETPLACE' | 'SNOWFLAKE' | 'SALESFORCE' | 'BIG_QUERY' | 'OPEN_FGA' | 'APP_STORE' | 'RECEIVED' | 'PREQUEL';
         }
         /**
          * Vendor-specific billing passthrough fields.
@@ -557,7 +634,7 @@ export declare namespace CustomerListResponse {
         /**
          * The vendor identifier of integration
          */
-        vendorIdentifier: 'AUTH0' | 'ZUORA' | 'STRIPE' | 'HUBSPOT' | 'AWS_MARKETPLACE' | 'SNOWFLAKE' | 'SALESFORCE' | 'BIG_QUERY' | 'OPEN_FGA' | 'APP_STORE';
+        vendorIdentifier: 'AUTH0' | 'ZUORA' | 'STRIPE' | 'HUBSPOT' | 'AWS_MARKETPLACE' | 'SNOWFLAKE' | 'SALESFORCE' | 'BIG_QUERY' | 'OPEN_FGA' | 'APP_STORE' | 'RECEIVED' | 'PREQUEL';
     }
     /**
      * Vendor-specific billing passthrough fields.
@@ -1036,49 +1113,73 @@ export declare namespace CustomerRetrieveEntitlementsResponse {
         }
     }
 }
+export interface CustomerRetrieveParams {
+    /**
+     * Account ID — optional when authenticating with a user JWT (Bearer token); falls
+     * back to the user's first membership. Ignored for API-key auth.
+     */
+    'X-ACCOUNT-ID'?: string;
+    /**
+     * Environment ID — required when authenticating with a user JWT (Bearer token) on
+     * environment-scoped endpoints. Ignored for API-key auth (env is intrinsic to the
+     * key).
+     */
+    'X-ENVIRONMENT-ID'?: string;
+}
 export interface CustomerUpdateParams {
     /**
-     * The billing currency of the customer
+     * Body param: The billing currency of the customer
      */
     billingCurrency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf' | null;
     /**
-     * The unique identifier for the entity in the billing provider
+     * Body param: The unique identifier for the entity in the billing provider
      */
     billingId?: string | null;
     /**
-     * Customer level coupon
+     * Body param: Customer level coupon
      */
     couponId?: (string & {}) | '' | null;
     /**
-     * The email of the customer
+     * Body param: The email of the customer
      */
     email?: string | null;
     /**
-     * List of integrations
+     * Body param: List of integrations
      */
     integrations?: Array<CustomerUpdateParams.Integration>;
     /**
-     * Language to use for this customer
+     * Body param: Language to use for this customer
      */
     language?: string | null;
     /**
-     * Additional metadata
+     * Body param: Additional metadata
      */
     metadata?: {
         [key: string]: string;
     };
     /**
-     * The name of the customer
+     * Body param: The name of the customer
      */
     name?: string | null;
     /**
-     * Vendor-specific billing passthrough fields.
+     * Body param: Vendor-specific billing passthrough fields.
      */
     passthrough?: CustomerUpdateParams.Passthrough;
     /**
-     * Timezone to use for this customer
+     * Body param: Timezone to use for this customer
      */
     timezone?: string | null;
+    /**
+     * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+     * token); falls back to the user's first membership. Ignored for API-key auth.
+     */
+    'X-ACCOUNT-ID'?: string;
+    /**
+     * Header param: Environment ID — required when authenticating with a user JWT
+     * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+     * intrinsic to the key).
+     */
+    'X-ENVIRONMENT-ID'?: string;
 }
 export declare namespace CustomerUpdateParams {
     /**
@@ -1096,7 +1197,7 @@ export declare namespace CustomerUpdateParams {
         /**
          * The vendor identifier of integration
          */
-        vendorIdentifier: 'AUTH0' | 'ZUORA' | 'STRIPE' | 'HUBSPOT' | 'AWS_MARKETPLACE' | 'SNOWFLAKE' | 'SALESFORCE' | 'BIG_QUERY' | 'OPEN_FGA' | 'APP_STORE';
+        vendorIdentifier: 'AUTH0' | 'ZUORA' | 'STRIPE' | 'HUBSPOT' | 'AWS_MARKETPLACE' | 'SNOWFLAKE' | 'SALESFORCE' | 'BIG_QUERY' | 'OPEN_FGA' | 'APP_STORE' | 'RECEIVED' | 'PREQUEL';
     }
     /**
      * Vendor-specific billing passthrough fields.
@@ -1280,17 +1381,28 @@ export declare namespace CustomerUpdateParams {
 }
 export interface CustomerListParams extends MyCursorIDPageParams {
     /**
-     * Filter by creation date using range operators: gt, gte, lt, lte
+     * Query param: Filter by creation date using range operators: gt, gte, lt, lte
      */
     createdAt?: CustomerListParams.CreatedAt;
     /**
-     * Filter by exact customer email address
+     * Query param: Filter by exact customer email address
      */
     email?: string;
     /**
-     * Filter by exact customer name
+     * Query param: Filter by exact customer name
      */
     name?: string;
+    /**
+     * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+     * token); falls back to the user's first membership. Ignored for API-key auth.
+     */
+    'X-ACCOUNT-ID'?: string;
+    /**
+     * Header param: Environment ID — required when authenticating with a user JWT
+     * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+     * intrinsic to the key).
+     */
+    'X-ENVIRONMENT-ID'?: string;
 }
 export declare namespace CustomerListParams {
     /**
@@ -1315,39 +1427,75 @@ export declare namespace CustomerListParams {
         lte?: string;
     }
 }
+export interface CustomerArchiveParams {
+    /**
+     * Account ID — optional when authenticating with a user JWT (Bearer token); falls
+     * back to the user's first membership. Ignored for API-key auth.
+     */
+    'X-ACCOUNT-ID'?: string;
+    /**
+     * Environment ID — required when authenticating with a user JWT (Bearer token) on
+     * environment-scoped endpoints. Ignored for API-key auth (env is intrinsic to the
+     * key).
+     */
+    'X-ENVIRONMENT-ID'?: string;
+}
 export interface CustomerCheckEntitlementParams {
     /**
-     * Currency ID (refId) to check for credit entitlements. Mutually exclusive with
-     * `featureId`.
+     * Query param: Currency ID (refId) to check for credit entitlements. Mutually
+     * exclusive with `featureId`.
      */
     currencyId?: string;
     /**
-     * Feature ID (refId) to check. Mutually exclusive with `currencyId`.
+     * Query param: Feature ID (refId) to check. Mutually exclusive with `currencyId`.
      */
     featureId?: string;
     /**
-     * Requested usage amount to evaluate against the entitlement limit (numeric
-     * features only)
+     * Query param: Requested usage amount to evaluate against the entitlement limit
+     * (numeric features only)
      */
     requestedUsage?: number;
     /**
-     * Requested values to evaluate against allowed values (enum features only)
+     * Query param: Requested values to evaluate against allowed values (enum features
+     * only)
      */
     requestedValues?: Array<string>;
     /**
-     * Resource ID to scope the entitlement check to a specific resource
+     * Query param: Resource ID to scope the entitlement check to a specific resource
      */
     resourceId?: string;
+    /**
+     * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+     * token); falls back to the user's first membership. Ignored for API-key auth.
+     */
+    'X-ACCOUNT-ID'?: string;
+    /**
+     * Header param: Environment ID — required when authenticating with a user JWT
+     * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+     * intrinsic to the key).
+     */
+    'X-ENVIRONMENT-ID'?: string;
 }
 export interface CustomerImportParams {
     /**
-     * List of customer objects to import
+     * Body param: List of customer objects to import
      */
     customers: Array<CustomerImportParams.Customer>;
     /**
-     * Integration details
+     * Body param: Integration details
      */
     integrationId?: string;
+    /**
+     * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+     * token); falls back to the user's first membership. Ignored for API-key auth.
+     */
+    'X-ACCOUNT-ID'?: string;
+    /**
+     * Header param: Environment ID — required when authenticating with a user JWT
+     * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+     * intrinsic to the key).
+     */
+    'X-ENVIRONMENT-ID'?: string;
 }
 export declare namespace CustomerImportParams {
     interface Customer {
@@ -1388,58 +1536,80 @@ export declare namespace CustomerImportParams {
     }
 }
 export interface CustomerListResourcesParams extends MyCursorIDPageParams {
+    /**
+     * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+     * token); falls back to the user's first membership. Ignored for API-key auth.
+     */
+    'X-ACCOUNT-ID'?: string;
+    /**
+     * Header param: Environment ID — required when authenticating with a user JWT
+     * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+     * intrinsic to the key).
+     */
+    'X-ENVIRONMENT-ID'?: string;
 }
 export interface CustomerProvisionParams {
     /**
-     * Customer slug
+     * Body param: Customer slug
      */
     id: string;
     /**
-     * The billing currency of the customer
+     * Body param: The billing currency of the customer
      */
     billingCurrency?: 'usd' | 'aed' | 'all' | 'amd' | 'ang' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bif' | 'bmd' | 'bnd' | 'bsd' | 'bwp' | 'byn' | 'bzd' | 'brl' | 'cad' | 'cdf' | 'chf' | 'cny' | 'czk' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'etb' | 'eur' | 'fjd' | 'gbp' | 'gel' | 'gip' | 'gmd' | 'gyd' | 'hkd' | 'hrk' | 'htg' | 'idr' | 'ils' | 'inr' | 'isk' | 'jmd' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'krw' | 'kyd' | 'kzt' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mvr' | 'mwk' | 'mxn' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nok' | 'npr' | 'nzd' | 'pgk' | 'php' | 'pkr' | 'pln' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sek' | 'sgd' | 'sle' | 'sll' | 'sos' | 'szl' | 'thb' | 'tjs' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'uzs' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'yer' | 'zar' | 'zmw' | 'clp' | 'djf' | 'gnf' | 'ugx' | 'pyg' | 'xof' | 'xpf' | null;
     /**
-     * The unique identifier for the entity in the billing provider
+     * Body param: The unique identifier for the entity in the billing provider
      */
     billingId?: string | null;
     /**
-     * Customer level coupon
+     * Body param: Customer level coupon
      */
     couponId?: (string & {}) | '' | null;
     /**
-     * The default payment method details
+     * Body param: The default payment method details
      */
     defaultPaymentMethod?: CustomerProvisionParams.DefaultPaymentMethod | null;
     /**
-     * The email of the customer
+     * Body param: The email of the customer
      */
     email?: string | null;
     /**
-     * List of integrations
+     * Body param: List of integrations
      */
     integrations?: Array<CustomerProvisionParams.Integration>;
     /**
-     * Language to use for this customer
+     * Body param: Language to use for this customer
      */
     language?: string | null;
     /**
-     * Additional metadata
+     * Body param: Additional metadata
      */
     metadata?: {
         [key: string]: string;
     };
     /**
-     * The name of the customer
+     * Body param: The name of the customer
      */
     name?: string | null;
     /**
-     * Vendor-specific billing passthrough fields.
+     * Body param: Vendor-specific billing passthrough fields.
      */
     passthrough?: CustomerProvisionParams.Passthrough;
     /**
-     * Timezone to use for this customer
+     * Body param: Timezone to use for this customer
      */
     timezone?: string | null;
+    /**
+     * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+     * token); falls back to the user's first membership. Ignored for API-key auth.
+     */
+    'X-ACCOUNT-ID'?: string;
+    /**
+     * Header param: Environment ID — required when authenticating with a user JWT
+     * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+     * intrinsic to the key).
+     */
+    'X-ENVIRONMENT-ID'?: string;
 }
 export declare namespace CustomerProvisionParams {
     /**
@@ -1482,7 +1652,7 @@ export declare namespace CustomerProvisionParams {
         /**
          * The vendor identifier of integration
          */
-        vendorIdentifier: 'AUTH0' | 'ZUORA' | 'STRIPE' | 'HUBSPOT' | 'AWS_MARKETPLACE' | 'SNOWFLAKE' | 'SALESFORCE' | 'BIG_QUERY' | 'OPEN_FGA' | 'APP_STORE';
+        vendorIdentifier: 'AUTH0' | 'ZUORA' | 'STRIPE' | 'HUBSPOT' | 'AWS_MARKETPLACE' | 'SNOWFLAKE' | 'SALESFORCE' | 'BIG_QUERY' | 'OPEN_FGA' | 'APP_STORE' | 'RECEIVED' | 'PREQUEL';
     }
     /**
      * Vendor-specific billing passthrough fields.
@@ -1666,13 +1836,37 @@ export declare namespace CustomerProvisionParams {
 }
 export interface CustomerRetrieveEntitlementsParams {
     /**
-     * Resource ID to scope entitlements to a specific resource
+     * Query param: Resource ID to scope entitlements to a specific resource
      */
     resourceId?: string;
+    /**
+     * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+     * token); falls back to the user's first membership. Ignored for API-key auth.
+     */
+    'X-ACCOUNT-ID'?: string;
+    /**
+     * Header param: Environment ID — required when authenticating with a user JWT
+     * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+     * intrinsic to the key).
+     */
+    'X-ENVIRONMENT-ID'?: string;
+}
+export interface CustomerUnarchiveParams {
+    /**
+     * Account ID — optional when authenticating with a user JWT (Bearer token); falls
+     * back to the user's first membership. Ignored for API-key auth.
+     */
+    'X-ACCOUNT-ID'?: string;
+    /**
+     * Environment ID — required when authenticating with a user JWT (Bearer token) on
+     * environment-scoped endpoints. Ignored for API-key auth (env is intrinsic to the
+     * key).
+     */
+    'X-ENVIRONMENT-ID'?: string;
 }
 export declare namespace Customers {
-    export { type CustomerIntegrationResponse as CustomerIntegrationResponse, type CustomerResponse as CustomerResponse, type CustomerListResponse as CustomerListResponse, type CustomerCheckEntitlementResponse as CustomerCheckEntitlementResponse, type CustomerImportResponse as CustomerImportResponse, type CustomerListResourcesResponse as CustomerListResourcesResponse, type CustomerRetrieveEntitlementsResponse as CustomerRetrieveEntitlementsResponse, type CustomerListResponsesMyCursorIDPage as CustomerListResponsesMyCursorIDPage, type CustomerListResourcesResponsesMyCursorIDPage as CustomerListResourcesResponsesMyCursorIDPage, type CustomerUpdateParams as CustomerUpdateParams, type CustomerListParams as CustomerListParams, type CustomerCheckEntitlementParams as CustomerCheckEntitlementParams, type CustomerImportParams as CustomerImportParams, type CustomerListResourcesParams as CustomerListResourcesParams, type CustomerProvisionParams as CustomerProvisionParams, type CustomerRetrieveEntitlementsParams as CustomerRetrieveEntitlementsParams, };
-    export { PaymentMethod as PaymentMethod, type PaymentMethodAttachParams as PaymentMethodAttachParams };
+    export { type CustomerIntegrationResponse as CustomerIntegrationResponse, type CustomerResponse as CustomerResponse, type CustomerListResponse as CustomerListResponse, type CustomerCheckEntitlementResponse as CustomerCheckEntitlementResponse, type CustomerImportResponse as CustomerImportResponse, type CustomerListResourcesResponse as CustomerListResourcesResponse, type CustomerRetrieveEntitlementsResponse as CustomerRetrieveEntitlementsResponse, type CustomerListResponsesMyCursorIDPage as CustomerListResponsesMyCursorIDPage, type CustomerListResourcesResponsesMyCursorIDPage as CustomerListResourcesResponsesMyCursorIDPage, type CustomerRetrieveParams as CustomerRetrieveParams, type CustomerUpdateParams as CustomerUpdateParams, type CustomerListParams as CustomerListParams, type CustomerArchiveParams as CustomerArchiveParams, type CustomerCheckEntitlementParams as CustomerCheckEntitlementParams, type CustomerImportParams as CustomerImportParams, type CustomerListResourcesParams as CustomerListResourcesParams, type CustomerProvisionParams as CustomerProvisionParams, type CustomerRetrieveEntitlementsParams as CustomerRetrieveEntitlementsParams, type CustomerUnarchiveParams as CustomerUnarchiveParams, };
+    export { PaymentMethod as PaymentMethod, type PaymentMethodAttachParams as PaymentMethodAttachParams, type PaymentMethodDetachParams as PaymentMethodDetachParams, };
     export { PromotionalEntitlements as PromotionalEntitlements, type PromotionalEntitlementCreateResponse as PromotionalEntitlementCreateResponse, type PromotionalEntitlementListResponse as PromotionalEntitlementListResponse, type PromotionalEntitlementRevokeResponse as PromotionalEntitlementRevokeResponse, type PromotionalEntitlementListResponsesMyCursorIDPage as PromotionalEntitlementListResponsesMyCursorIDPage, type PromotionalEntitlementCreateParams as PromotionalEntitlementCreateParams, type PromotionalEntitlementListParams as PromotionalEntitlementListParams, type PromotionalEntitlementRevokeParams as PromotionalEntitlementRevokeParams, };
     export { Integrations as Integrations, type IntegrationListResponse as IntegrationListResponse, type IntegrationListResponsesMyCursorIDPage as IntegrationListResponsesMyCursorIDPage, type IntegrationRetrieveParams as IntegrationRetrieveParams, type IntegrationUpdateParams as IntegrationUpdateParams, type IntegrationListParams as IntegrationListParams, type IntegrationLinkParams as IntegrationLinkParams, type IntegrationUnlinkParams as IntegrationUnlinkParams, };
 }