@paid-ai/paid-node 1.8.0 → 2.0.0

package/dist/esm/api/resources/customers/client/Client.d.mts

@@ -26,13 +26,14 @@ export declare class Customers {
     listCustomers(request?: Paid.ListCustomersRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerListResponse>;
     private __listCustomers;
     /**
-     * Creates a new customer for the organization
+     * Creates a new customer for the organization. `externalId` shares one set of ids with customer unit ids and aliases, unique across the organization and ignoring letter case: an external id that another customer already holds as a unit id or alias, or as its external id in another case, is refused with `409 EXTERNAL_ID_IN_USE`. The same id in the same case is `400 DUPLICATE_EXTERNAL_ID`, as before.
      *
      * @param {Paid.CreateCustomerRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example
@@ -61,7 +62,7 @@ export declare class Customers {
     listCustomerAliases(request: Paid.ListCustomerAliasesRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerAliasListResponse>;
     private __listCustomerAliases;
     /**
-     * Create an alternate external identifier for a customer by Paid display ID.
+     * Create an alternate external identifier for a customer by Paid display ID. The alias shares one set of ids with customer external ids and unit ids, unique within the organization and ignoring letter case: an alias that another customer already holds as its external id, a unit id or an alias is refused with `409 EXTERNAL_ID_IN_USE` (an exact match keeps its older code, `ALIAS_CONFLICTS_WITH_CUSTOMER_EXTERNAL_ID` or `CUSTOMER_ALIAS_ALREADY_EXISTS`).
      *
      * @param {Paid.CreateCustomerAliasRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -118,7 +119,7 @@ export declare class Customers {
     getCustomerById(request: Paid.GetCustomerByIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.Customer>;
     private __getCustomerById;
     /**
-     * Update a customer by Paid display ID. Use the value returned as `customer.id`, for example `cus_abc123`. If you have your own customer ID, use `PUT /api/v2/customers/external/{externalId}`.
+     * Update a customer by Paid display ID. Use the value returned as `customer.id`, for example `cus_abc123`. If you have your own customer ID, use `PUT /api/v2/customers/external/{externalId}`. Changing `externalId` follows the organization-wide id rule: a new id that another customer already holds as its external id, a unit id or an alias, ignoring letter case, is refused with `409 EXTERNAL_ID_IN_USE`; the same id in the same case stays `400 DUPLICATE_EXTERNAL_ID`. When the id changes, the previous id is kept as an alias of the customer, so signals that still use it keep resolving to it.
      *
      * @param {Paid.UpdateCustomerByIdRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -126,6 +127,7 @@ export declare class Customers {
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example
@@ -137,7 +139,7 @@ export declare class Customers {
     updateCustomerById(request: Paid.UpdateCustomerByIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.Customer>;
     private __updateCustomerById;
     /**
-     * Delete a customer by Paid display ID. Use the value returned as `customer.id`, for example `cus_abc123`. If you have your own customer ID, use `DELETE /api/v2/customers/external/{externalId}`.
+     * Delete a customer by Paid display ID. Use the value returned as `customer.id`, for example `cus_abc123`. If you have your own customer ID, use `DELETE /api/v2/customers/external/{externalId}`. A customer that still has orders, invoices, payments, contacts, child customers or other linked records is not deleted: the request returns 409 `CUSTOMER_HAS_ASSOCIATIONS` and `details` lists what is linked.
      *
      * @param {Paid.DeleteCustomerByIdRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -145,6 +147,7 @@ export declare class Customers {
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example
@@ -190,7 +193,7 @@ export declare class Customers {
     listCustomerAliasesByExternalId(request: Paid.ListCustomerAliasesByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerAliasListResponse>;
     private __listCustomerAliasesByExternalId;
     /**
-     * Create an alternate external identifier for a customer by external ID.
+     * Create an alternate external identifier for a customer by external ID. The alias shares one set of ids with customer external ids and unit ids, unique within the organization and ignoring letter case: an alias that another customer already holds as its external id, a unit id or an alias is refused with `409 EXTERNAL_ID_IN_USE` (an exact match keeps its older code, `ALIAS_CONFLICTS_WITH_CUSTOMER_EXTERNAL_ID` or `CUSTOMER_ALIAS_ALREADY_EXISTS`).
      *
      * @param {Paid.CreateCustomerAliasByExternalIdRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -247,7 +250,7 @@ export declare class Customers {
     getCustomerByExternalId(request: Paid.GetCustomerByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.Customer>;
     private __getCustomerByExternalId;
     /**
-     * Update a customer by external ID
+     * Update a customer by external ID. Changing `externalId` follows the organization-wide id rule: a new id that another customer already holds as its external id, a unit id or an alias, ignoring letter case, is refused with `409 EXTERNAL_ID_IN_USE`; the same id in the same case stays `400 DUPLICATE_EXTERNAL_ID`. When the id changes, the previous id is kept as an alias of the customer, so signals that still use it keep resolving to it.
      *
      * @param {Paid.UpdateCustomerByExternalIdRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -255,6 +258,7 @@ export declare class Customers {
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example
@@ -266,7 +270,7 @@ export declare class Customers {
     updateCustomerByExternalId(request: Paid.UpdateCustomerByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.Customer>;
     private __updateCustomerByExternalId;
     /**
-     * Delete a customer by external ID
+     * Delete a customer by external ID. A customer that still has orders, invoices, payments, contacts, child customers or other linked records is not deleted: the request returns 409 `CUSTOMER_HAS_ASSOCIATIONS` and `details` lists what is linked.
      *
      * @param {Paid.DeleteCustomerByExternalIdRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -274,6 +278,7 @@ export declare class Customers {
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example
@@ -326,6 +331,7 @@ export declare class Customers {
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example
@@ -335,7 +341,8 @@ export declare class Customers {
      *             creditCurrencyKey: "api_credits",
      *             amount: 10000,
      *             startsAt: "2026-06-05T12:00:00Z",
-     *             expiresAt: "2026-12-31T23:59:59Z"
+     *             expiresAt: "2026-12-31T23:59:59Z",
+     *             idempotencyKey: "grant_acme_2026-06-05"
      *         }
      *     })
      */
@@ -403,6 +410,7 @@ export declare class Customers {
      * @throws {@link Paid.BadRequestError}
      * @throws {@link Paid.ForbiddenError}
      * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
      * @throws {@link Paid.InternalServerError}
      *
      * @example
@@ -412,7 +420,8 @@ export declare class Customers {
      *             creditCurrencyKey: "api_credits",
      *             amount: 10000,
      *             startsAt: "2026-06-05T12:00:00Z",
-     *             expiresAt: "2026-12-31T23:59:59Z"
+     *             expiresAt: "2026-12-31T23:59:59Z",
+     *             idempotencyKey: "grant_acme_2026-06-05"
      *         }
      *     })
      */
@@ -438,7 +447,85 @@ export declare class Customers {
     upsertCustomerUserByExternalId(request: Paid.UpsertCustomerUserRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUser>;
     private __upsertCustomerUserByExternalId;
     /**
-     * Lists the customer's units as a flat list, newest last; assemble the tree from `parentExternalId` (`null` on the root unit, `isRoot: true`). Deleted units are hidden unless `status=DELETED` is given. Filter by `externalType`, or by `parentExternalId` for one level of the tree. Addresses the customer by your external customer id.
+     * Returns the virtual bank account (Stripe funding instructions) a customer can pay by bank transfer into, by Paid display ID.
+     *
+     * @param {Paid.GetCustomerFundingInstructionsRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.getCustomerFundingInstructions({
+     *         id: "cus_abc123",
+     *         currency: "USD"
+     *     })
+     */
+    getCustomerFundingInstructions(request: Paid.GetCustomerFundingInstructionsRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerFundingInstructions>;
+    private __getCustomerFundingInstructions;
+    /**
+     * Creates a dedicated virtual bank account for the customer to pay invoices by bank transfer, by Paid display ID. Returns the existing account if one already exists for the currency. Requires a live-mode organization with Stripe connected and Bank Transfers enabled on the Stripe account.
+     *
+     * @param {Paid.CreateCustomerFundingInstructionsRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.UnprocessableEntityError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.createCustomerFundingInstructions({
+     *         id: "cus_abc123",
+     *         body: {}
+     *     })
+     */
+    createCustomerFundingInstructions(request: Paid.CreateCustomerFundingInstructionsRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerFundingInstructions>;
+    private __createCustomerFundingInstructions;
+    /**
+     * Returns the virtual bank account (Stripe funding instructions) a customer can pay by bank transfer into, by your external ID.
+     *
+     * @param {Paid.GetCustomerFundingInstructionsByExternalIdRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.getCustomerFundingInstructionsByExternalId({
+     *         externalId: "externalId",
+     *         currency: "USD"
+     *     })
+     */
+    getCustomerFundingInstructionsByExternalId(request: Paid.GetCustomerFundingInstructionsByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerFundingInstructions>;
+    private __getCustomerFundingInstructionsByExternalId;
+    /**
+     * Creates a dedicated virtual bank account for the customer to pay invoices by bank transfer, by your external ID. Returns the existing account if one already exists for the currency. Requires a live-mode organization with Stripe connected and Bank Transfers enabled on the Stripe account.
+     *
+     * @param {Paid.CreateCustomerFundingInstructionsByExternalIdRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.UnprocessableEntityError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.createCustomerFundingInstructionsByExternalId({
+     *         externalId: "externalId",
+     *         body: {}
+     *     })
+     */
+    createCustomerFundingInstructionsByExternalId(request: Paid.CreateCustomerFundingInstructionsByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerFundingInstructions>;
+    private __createCustomerFundingInstructionsByExternalId;
+    /**
+     * Lists the customer's units as a flat list, newest last; assemble the tree from `parentExternalId` (`null` on the root unit, `isRoot: true`). Deleted units are hidden unless `status=DELETED` is given, drafts unless `status=DRAFT`. Filter by `externalType`, or by `parentExternalId` for one level of the tree. Addresses the customer by your external customer id.
      *
      * @param {Paid.ListCustomerUnitsByExternalIdRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -457,7 +544,7 @@ export declare class Customers {
     listCustomerUnitsByExternalId(request: Paid.ListCustomerUnitsByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnitListResponse>;
     private __listCustomerUnitsByExternalId;
     /**
-     * Creates a unit for this customer. `externalId` is your own key for it: required, unique within the customer and immutable; every unit route addresses the unit by it, and `name` defaults to it. Omit `parentExternalId` to create the customer's root unit (its first unit; `409 ROOT_EXISTS` if it already has one — a customer created with an external id usable as a unit key already has its root, keyed by that external id, so name it as the parent instead); otherwise the parent must exist (`409 PARENT_NOT_FOUND`) and be ACTIVE. Units are never created implicitly: a signal that names a unit before it exists is accepted and its spend attaches to the unit once you create it with that key. `409` also when the externalId is taken (`CUSTOMER_UNIT_EXISTS`), the tree would get too deep, or the customer is on seat-based billing. Addresses the customer by your external customer id.
+     * Creates a unit for this customer. `externalId` is your own key for it: required, immutable, and unique within the organization (no other customer's unit id, external id or alias may be the same, ignoring letter case); every unit route addresses the unit by it, and `name` defaults to it. Omit `parentExternalId` to create the customer's root unit (its first unit; `409 ROOT_EXISTS` if it already has one — a customer created with an external id usable as a unit key already has its root, keyed by that external id, so name it as the parent instead); otherwise the parent must exist (`409 PARENT_NOT_FOUND`) and be ACTIVE. A create whose `externalId` is one of this customer's `DRAFT` units promotes the draft in place: same unit, same id, now ACTIVE with the request's name, type, metadata and parent (`parentExternalId` is required; a draft sits under the root). A signal that names a unit before it exists is accepted; with draft units enabled for your organization it creates a `DRAFT` unit under the customer's root that holds the key, and creating the unit with that key later promotes the draft; otherwise its spend attaches to the unit once you create it with that key. `409` also when the externalId is taken on this customer (`CUSTOMER_UNIT_EXISTS`) or by another customer of the organization (`EXTERNAL_ID_IN_USE`), the tree would get too deep, the customer is on seat-based billing, or a root unit is sent with `billable: false` (`ROOT_UNIT_ALWAYS_BILLABLE`). `403 FEATURE_NOT_ENABLED` for `billable: false` when non-billable units are not enabled for your organization. Addresses the customer by your external customer id.
      *
      * @param {Paid.CreateCustomerUnitByExternalIdRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -498,7 +585,7 @@ export declare class Customers {
     getCustomerUnitByExternalId(request: Paid.GetCustomerUnitByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnit>;
     private __getCustomerUnitByExternalId;
     /**
-     * Soft-deletes a unit: it stays readable with `status: DELETED` and cannot be reactivated. Spend history that references it is kept, and signals that keep naming it are still attributed to it. `409` while the unit has ACTIVE children or a cap in force or scheduled; the root follows the same rules, and once it is deleted a new root can be created. Addresses the customer by your external customer id.
+     * Soft-deletes a unit: it stays readable with `status: DELETED` and cannot be reactivated. Spend history that references it is kept, and signals that keep naming it are still attributed to it. A `DRAFT` unit is deleted the same way: it stays readable as DELETED, its key stays reserved, and spend already keyed to it stays its own. `409` while the unit has ACTIVE or DRAFT children or a cap in force or scheduled; the root follows the same rules, and once it is deleted a new root can be created. Addresses the customer by your external customer id.
      *
      * @param {Paid.DeleteCustomerUnitByExternalIdRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -518,7 +605,7 @@ export declare class Customers {
     deleteCustomerUnitByExternalId(request: Paid.DeleteCustomerUnitByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnit>;
     private __deleteCustomerUnitByExternalId;
     /**
-     * Renames, re-types, re-parents or annotates a unit, the root included. `externalId` cannot change. Re-parenting (`parentExternalId`) moves the unit with everything under it. Spend already recorded keeps naming the unit it landed on; caps are evaluated on the current tree, so from the move on the unit's spend in the running cap period counts toward its new ancestors' caps and no longer toward the old ones. `409` for a deleted unit, a parent that does not exist or is not ACTIVE, a move of the root (`ROOT_UNIT_IMMOVABLE`), a move under the unit's own subtree, or a tree that would get too deep. Addresses the customer by your external customer id.
+     * Renames, re-types, re-parents or annotates a unit, the root included. `externalId` cannot change. Re-parenting (`parentExternalId`) moves the unit with everything under it. Spend already recorded keeps naming the unit it landed on; caps are evaluated on the current tree, so from the move on the unit's spend in the running cap period counts toward its new ancestors' caps and no longer toward the old ones. `billable` flips the unit's own setting; moving a unit under a non-billable one makes it non-billable in effect (`effectiveBillable`). `409` for a deleted unit (`CUSTOMER_UNIT_DELETED`), a draft (`CUSTOMER_UNIT_DRAFT`), a parent that does not exist or is not ACTIVE, a move of the root (`ROOT_UNIT_IMMOVABLE`), `billable: false` on the root (`ROOT_UNIT_ALWAYS_BILLABLE`), a move under the unit's own subtree, or a tree that would get too deep. `403 FEATURE_NOT_ENABLED` for `billable: false` when non-billable units are not enabled for your organization. Addresses the customer by your external customer id.
      *
      * @param {Paid.UpdateCustomerUnitByExternalIdRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -539,7 +626,69 @@ export declare class Customers {
     updateCustomerUnitByExternalId(request: Paid.UpdateCustomerUnitByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnit>;
     private __updateCustomerUnitByExternalId;
     /**
-     * Lists the customer's units as a flat list, newest last; assemble the tree from `parentExternalId` (`null` on the root unit, `isRoot: true`). Deleted units are hidden unless `status=DELETED` is given. Filter by `externalType`, or by `parentExternalId` for one level of the tree. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
+     * Lists the aliases that land signals on this unit. A customer-level alias (created on the customer routes) points at the customer's root unit, so it is listed under the root. Addresses the customer by your external customer id.
+     *
+     * @param {Paid.ListCustomerUnitAliasesByExternalIdRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.listCustomerUnitAliasesByExternalId({
+     *         externalId: "customer_123",
+     *         externalCustomerUnitId: "team-research"
+     *     })
+     */
+    listCustomerUnitAliasesByExternalId(request: Paid.ListCustomerUnitAliasesByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerAliasListResponse>;
+    private __listCustomerUnitAliasesByExternalId;
+    /**
+     * Creates an alias that lands signals on this unit: a signal whose `externalCustomerId` is the alias resolves to this customer and, when it names no `customerUnit`, to this unit. The alias shares one set of ids with customer external ids and unit ids, unique within the organization and ignoring letter case: an alias another customer holds is refused with `409 EXTERNAL_ID_IN_USE`. Addresses the customer by your external customer id.
+     *
+     * @param {Paid.CreateCustomerUnitAliasByExternalIdRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.createCustomerUnitAliasByExternalId({
+     *         externalId: "customer_123",
+     *         externalCustomerUnitId: "team-research",
+     *         body: {
+     *             alias: "child-customer-1"
+     *         }
+     *     })
+     */
+    createCustomerUnitAliasByExternalId(request: Paid.CreateCustomerUnitAliasByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerAlias>;
+    private __createCustomerUnitAliasByExternalId;
+    /**
+     * Deletes an alias of this unit. Signals still sent with it then resolve to nothing again. Addresses the customer by your external customer id.
+     *
+     * @param {Paid.DeleteCustomerUnitAliasByExternalIdRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.deleteCustomerUnitAliasByExternalId({
+     *         externalId: "customer_123",
+     *         externalCustomerUnitId: "team-research",
+     *         alias: "tenant-7-sandbox"
+     *     })
+     */
+    deleteCustomerUnitAliasByExternalId(request: Paid.DeleteCustomerUnitAliasByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.DeleteCustomerUnitAliasByExternalIdResponse>;
+    private __deleteCustomerUnitAliasByExternalId;
+    /**
+     * Lists the customer's units as a flat list, newest last; assemble the tree from `parentExternalId` (`null` on the root unit, `isRoot: true`). Deleted units are hidden unless `status=DELETED` is given, drafts unless `status=DRAFT`. Filter by `externalType`, or by `parentExternalId` for one level of the tree. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
      *
      * @param {Paid.ListCustomerUnitsRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -558,7 +707,7 @@ export declare class Customers {
     listCustomerUnits(request: Paid.ListCustomerUnitsRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnitListResponse>;
     private __listCustomerUnits;
     /**
-     * Creates a unit for this customer. `externalId` is your own key for it: required, unique within the customer and immutable; every unit route addresses the unit by it, and `name` defaults to it. Omit `parentExternalId` to create the customer's root unit (its first unit; `409 ROOT_EXISTS` if it already has one — a customer created with an external id usable as a unit key already has its root, keyed by that external id, so name it as the parent instead); otherwise the parent must exist (`409 PARENT_NOT_FOUND`) and be ACTIVE. Units are never created implicitly: a signal that names a unit before it exists is accepted and its spend attaches to the unit once you create it with that key. `409` also when the externalId is taken (`CUSTOMER_UNIT_EXISTS`), the tree would get too deep, or the customer is on seat-based billing. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
+     * Creates a unit for this customer. `externalId` is your own key for it: required, immutable, and unique within the organization (no other customer's unit id, external id or alias may be the same, ignoring letter case); every unit route addresses the unit by it, and `name` defaults to it. Omit `parentExternalId` to create the customer's root unit (its first unit; `409 ROOT_EXISTS` if it already has one — a customer created with an external id usable as a unit key already has its root, keyed by that external id, so name it as the parent instead); otherwise the parent must exist (`409 PARENT_NOT_FOUND`) and be ACTIVE. A create whose `externalId` is one of this customer's `DRAFT` units promotes the draft in place: same unit, same id, now ACTIVE with the request's name, type, metadata and parent (`parentExternalId` is required; a draft sits under the root). A signal that names a unit before it exists is accepted; with draft units enabled for your organization it creates a `DRAFT` unit under the customer's root that holds the key, and creating the unit with that key later promotes the draft; otherwise its spend attaches to the unit once you create it with that key. `409` also when the externalId is taken on this customer (`CUSTOMER_UNIT_EXISTS`) or by another customer of the organization (`EXTERNAL_ID_IN_USE`), the tree would get too deep, the customer is on seat-based billing, or a root unit is sent with `billable: false` (`ROOT_UNIT_ALWAYS_BILLABLE`). `403 FEATURE_NOT_ENABLED` for `billable: false` when non-billable units are not enabled for your organization. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
      *
      * @param {Paid.CreateCustomerUnitRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -599,7 +748,7 @@ export declare class Customers {
     getCustomerUnit(request: Paid.GetCustomerUnitRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnit>;
     private __getCustomerUnit;
     /**
-     * Soft-deletes a unit: it stays readable with `status: DELETED` and cannot be reactivated. Spend history that references it is kept, and signals that keep naming it are still attributed to it. `409` while the unit has ACTIVE children or a cap in force or scheduled; the root follows the same rules, and once it is deleted a new root can be created. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
+     * Soft-deletes a unit: it stays readable with `status: DELETED` and cannot be reactivated. Spend history that references it is kept, and signals that keep naming it are still attributed to it. A `DRAFT` unit is deleted the same way: it stays readable as DELETED, its key stays reserved, and spend already keyed to it stays its own. `409` while the unit has ACTIVE or DRAFT children or a cap in force or scheduled; the root follows the same rules, and once it is deleted a new root can be created. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
      *
      * @param {Paid.DeleteCustomerUnitRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -619,7 +768,7 @@ export declare class Customers {
     deleteCustomerUnit(request: Paid.DeleteCustomerUnitRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnit>;
     private __deleteCustomerUnit;
     /**
-     * Renames, re-types, re-parents or annotates a unit, the root included. `externalId` cannot change. Re-parenting (`parentExternalId`) moves the unit with everything under it. Spend already recorded keeps naming the unit it landed on; caps are evaluated on the current tree, so from the move on the unit's spend in the running cap period counts toward its new ancestors' caps and no longer toward the old ones. `409` for a deleted unit, a parent that does not exist or is not ACTIVE, a move of the root (`ROOT_UNIT_IMMOVABLE`), a move under the unit's own subtree, or a tree that would get too deep. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
+     * Renames, re-types, re-parents or annotates a unit, the root included. `externalId` cannot change. Re-parenting (`parentExternalId`) moves the unit with everything under it. Spend already recorded keeps naming the unit it landed on; caps are evaluated on the current tree, so from the move on the unit's spend in the running cap period counts toward its new ancestors' caps and no longer toward the old ones. `billable` flips the unit's own setting; moving a unit under a non-billable one makes it non-billable in effect (`effectiveBillable`). `409` for a deleted unit (`CUSTOMER_UNIT_DELETED`), a draft (`CUSTOMER_UNIT_DRAFT`), a parent that does not exist or is not ACTIVE, a move of the root (`ROOT_UNIT_IMMOVABLE`), `billable: false` on the root (`ROOT_UNIT_ALWAYS_BILLABLE`), a move under the unit's own subtree, or a tree that would get too deep. `403 FEATURE_NOT_ENABLED` for `billable: false` when non-billable units are not enabled for your organization. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
      *
      * @param {Paid.UpdateCustomerUnitRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -639,6 +788,283 @@ export declare class Customers {
      */
     updateCustomerUnit(request: Paid.UpdateCustomerUnitRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnit>;
     private __updateCustomerUnit;
+    /**
+     * Lists the aliases that land signals on this unit. A customer-level alias (created on the customer routes) points at the customer's root unit, so it is listed under the root. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
+     *
+     * @param {Paid.ListCustomerUnitAliasesRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.listCustomerUnitAliases({
+     *         id: "cus_abc123",
+     *         externalCustomerUnitId: "team-research"
+     *     })
+     */
+    listCustomerUnitAliases(request: Paid.ListCustomerUnitAliasesRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerAliasListResponse>;
+    private __listCustomerUnitAliases;
+    /**
+     * Creates an alias that lands signals on this unit: a signal whose `externalCustomerId` is the alias resolves to this customer and, when it names no `customerUnit`, to this unit. The alias shares one set of ids with customer external ids and unit ids, unique within the organization and ignoring letter case: an alias another customer holds is refused with `409 EXTERNAL_ID_IN_USE`. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
+     *
+     * @param {Paid.CreateCustomerUnitAliasRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.createCustomerUnitAlias({
+     *         id: "cus_abc123",
+     *         externalCustomerUnitId: "team-research",
+     *         body: {
+     *             alias: "child-customer-1"
+     *         }
+     *     })
+     */
+    createCustomerUnitAlias(request: Paid.CreateCustomerUnitAliasRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerAlias>;
+    private __createCustomerUnitAlias;
+    /**
+     * Deletes an alias of this unit. Signals still sent with it then resolve to nothing again. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
+     *
+     * @param {Paid.DeleteCustomerUnitAliasRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.deleteCustomerUnitAlias({
+     *         id: "cus_abc123",
+     *         externalCustomerUnitId: "team-research",
+     *         alias: "tenant-7-sandbox"
+     *     })
+     */
+    deleteCustomerUnitAlias(request: Paid.DeleteCustomerUnitAliasRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.DeleteCustomerUnitAliasResponse>;
+    private __deleteCustomerUnitAlias;
+    /**
+     * Returns a unit by its key without naming its customer. The answer carries the customer's ids (`customerId`, `customerExternalId`) so the customer routes are one hop away, but, like the create on this path, not Paid's unit id: a caller of these routes names units by key. The key is looked up across the organization ignoring letter case. When more than one unit carries it in another letter case (legacy duplicates across customers, or case variants on one customer), the exact spelling decides; when that does not single one out either, the answer is `409 CUSTOMER_UNIT_AMBIGUOUS`: use the customer's unit routes, where the key is exact.
+     *
+     * @param {Paid.GetCustomerUnitByKeyRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.getCustomerUnitByKey({
+     *         externalCustomerUnitId: "team-research"
+     *     })
+     */
+    getCustomerUnitByKey(request: Paid.GetCustomerUnitByKeyRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnitByKey>;
+    private __getCustomerUnitByKey;
+    /**
+     * Lists the aliases that land signals on this unit, without naming its customer. The key is looked up across the organization ignoring letter case. When more than one unit carries it in another letter case (legacy duplicates across customers, or case variants on one customer), the exact spelling decides; when that does not single one out either, the answer is `409 CUSTOMER_UNIT_AMBIGUOUS`: use the customer's unit routes, where the key is exact.
+     *
+     * @param {Paid.ListCustomerUnitAliasesByKeyRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.listCustomerUnitAliasesByKey({
+     *         externalCustomerUnitId: "team-research"
+     *     })
+     */
+    listCustomerUnitAliasesByKey(request: Paid.ListCustomerUnitAliasesByKeyRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerAliasListResponse>;
+    private __listCustomerUnitAliasesByKey;
+    /**
+     * Creates an alias that lands signals on this unit, without naming its customer: a signal whose `externalCustomerId` is the alias resolves to the unit's customer and is attributed to this unit. The alias must be unique within the organization ignoring letter case (`409 EXTERNAL_ID_IN_USE`). The key is looked up across the organization ignoring letter case. When more than one unit carries it in another letter case (legacy duplicates across customers, or case variants on one customer), the exact spelling decides; when that does not single one out either, the answer is `409 CUSTOMER_UNIT_AMBIGUOUS`: use the customer's unit routes, where the key is exact.
+     *
+     * @param {Paid.CreateCustomerUnitAliasByKeyRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.createCustomerUnitAliasByKey({
+     *         externalCustomerUnitId: "team-research",
+     *         body: {
+     *             alias: "child-customer-1"
+     *         }
+     *     })
+     */
+    createCustomerUnitAliasByKey(request: Paid.CreateCustomerUnitAliasByKeyRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerAlias>;
+    private __createCustomerUnitAliasByKey;
+    /**
+     * Deletes an alias of this unit, without naming its customer. Signals still sent with it then resolve to nothing again. The key is looked up across the organization ignoring letter case. When more than one unit carries it in another letter case (legacy duplicates across customers, or case variants on one customer), the exact spelling decides; when that does not single one out either, the answer is `409 CUSTOMER_UNIT_AMBIGUOUS`: use the customer's unit routes, where the key is exact.
+     *
+     * @param {Paid.DeleteCustomerUnitAliasByKeyRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.deleteCustomerUnitAliasByKey({
+     *         externalCustomerUnitId: "team-research",
+     *         alias: "tenant-7"
+     *     })
+     */
+    deleteCustomerUnitAliasByKey(request: Paid.DeleteCustomerUnitAliasByKeyRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.DeleteCustomerUnitAliasByKeyResponse>;
+    private __deleteCustomerUnitAliasByKey;
+    /**
+     * Creates a unit by naming its parent alone; the customer is whoever the parent belongs to, so a caller that only knows its own ids never needs the customer routes. `parentExternalId` is looked up across the organization, ignoring letter case, among unit ids, customer external ids and aliases: a unit becomes the parent; a customer (by external id or alias) stands for the top of its tree, so the new unit goes under the root unit, or becomes the root when the customer has none. The parent is only ever named by your id, never by a Paid id, so a customer with no external id takes its units through the customer's unit routes. The answer carries the unit's `externalId` and its customer's ids, not Paid's unit id. `externalId` follows the same rules as on the customer-scoped create: required, immutable, unique within the organization ignoring letter case. `409 PARENT_NOT_FOUND` when nothing matches, `PARENT_NOT_ACTIVE` for a deleted or draft parent, `PARENT_AMBIGUOUS` when legacy rows let the id name more than one customer (use that customer's unit routes), `PARENT_CHANGED` when the reference pointed elsewhere by the time the create ran (send it again), and otherwise the customer-scoped create's 409s (`CUSTOMER_UNIT_EXISTS`, `EXTERNAL_ID_IN_USE`, `DEPTH_EXCEEDED`, `SEAT_BILLING`, and `ROOT_UNIT_ALWAYS_BILLABLE` for `billable: false` on a unit that would become the root). `403 FEATURE_NOT_ENABLED` for `billable: false` when non-billable units are not enabled for your organization.
+     *
+     * @param {Paid.CustomerUnitCreateUnderParent} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.ConflictError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.createCustomerUnitUnderParent({
+     *         externalId: "team-research",
+     *         parentExternalId: "dept-rnd"
+     *     })
+     */
+    createCustomerUnitUnderParent(request: Paid.CustomerUnitCreateUnderParent, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnitCreatedUnderParent>;
+    private __createCustomerUnitUnderParent;
+    /**
+     * Lists this customer's API keys, newest first and paginated, revoked and expired ones included. The secret is never returned; `keyPrefix` and `last4` identify each key. Addresses the customer by your external customer id.
+     *
+     * @param {Paid.ListCustomerApiKeysByExternalIdRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.listCustomerApiKeysByExternalId({
+     *         externalId: "customer_123"
+     *     })
+     */
+    listCustomerApiKeysByExternalId(request: Paid.ListCustomerApiKeysByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerApiKeyList>;
+    private __listCustomerApiKeysByExternalId;
+    /**
+     * Creates an API key bound to this customer. The response carries the secret in `key`, returned only this once: store it immediately, as Paid keeps only its hash. The key acts for this customer alone: it can send signals for this customer through `POST /api/v2/signals/bulk`, and every other route refuses it. Requires `write:api-keys`, which full-access keys hold; a restricted key needs the scope granted explicitly. Addresses the customer by your external customer id.
+     *
+     * @param {Paid.CreateCustomerApiKeyByExternalIdRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.createCustomerApiKeyByExternalId({
+     *         externalId: "customer_123",
+     *         body: {
+     *             name: "Tenant runtime (production)"
+     *         }
+     *     })
+     */
+    createCustomerApiKeyByExternalId(request: Paid.CreateCustomerApiKeyByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerApiKeyCreated>;
+    private __createCustomerApiKeyByExternalId;
+    /**
+     * Revokes one of this customer's keys, which then stops authenticating. Keys are never deleted: a revoked key stays listed with `revokedAt` set, and deleting the customer revokes its keys too. Revoking an already revoked key returns it unchanged. `404` when the key does not belong to this customer. Addresses the customer by your external customer id.
+     *
+     * @param {Paid.RevokeCustomerApiKeyByExternalIdRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.revokeCustomerApiKeyByExternalId({
+     *         externalId: "customer_123",
+     *         apiKeyId: "apiKeyId"
+     *     })
+     */
+    revokeCustomerApiKeyByExternalId(request: Paid.RevokeCustomerApiKeyByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerApiKey>;
+    private __revokeCustomerApiKeyByExternalId;
+    /**
+     * Lists this customer's API keys, newest first and paginated, revoked and expired ones included. The secret is never returned; `keyPrefix` and `last4` identify each key. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
+     *
+     * @param {Paid.ListCustomerApiKeysRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.listCustomerApiKeys({
+     *         id: "cus_abc123"
+     *     })
+     */
+    listCustomerApiKeys(request: Paid.ListCustomerApiKeysRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerApiKeyList>;
+    private __listCustomerApiKeys;
+    /**
+     * Creates an API key bound to this customer. The response carries the secret in `key`, returned only this once: store it immediately, as Paid keeps only its hash. The key acts for this customer alone: it can send signals for this customer through `POST /api/v2/signals/bulk`, and every other route refuses it. Requires `write:api-keys`, which full-access keys hold; a restricted key needs the scope granted explicitly. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
+     *
+     * @param {Paid.CreateCustomerApiKeyRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.createCustomerApiKey({
+     *         id: "cus_abc123",
+     *         body: {
+     *             name: "Tenant runtime (production)"
+     *         }
+     *     })
+     */
+    createCustomerApiKey(request: Paid.CreateCustomerApiKeyRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerApiKeyCreated>;
+    private __createCustomerApiKey;
+    /**
+     * Revokes one of this customer's keys, which then stops authenticating. Keys are never deleted: a revoked key stays listed with `revokedAt` set, and deleting the customer revokes its keys too. Revoking an already revoked key returns it unchanged. `404` when the key does not belong to this customer. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
+     *
+     * @param {Paid.RevokeCustomerApiKeyRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.revokeCustomerApiKey({
+     *         id: "cus_abc123",
+     *         apiKeyId: "apiKeyId"
+     *     })
+     */
+    revokeCustomerApiKey(request: Paid.RevokeCustomerApiKeyRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerApiKey>;
+    private __revokeCustomerApiKey;
     /**
      * Returns the cap in force on this customer unit for one credits currency, with usage in the current period when available. Select the currency with `creditsCurrencyId`; it may be omitted only when the organization has exactly one credits currency, which is then used and echoed back. `404` when the customer or the unit does not exist, or the unit has no cap in force for that currency. The usage figures are advisory: other spend may land between this read and the next burn. Addresses the customer by your external customer id.
      *
@@ -660,7 +1086,7 @@ export declare class Customers {
     getCustomerUnitCapByExternalId(request: Paid.GetCustomerUnitCapByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnitCapResponse>;
     private __getCustomerUnitCapByExternalId;
     /**
-     * Sets the cap on this customer unit for one credits currency by recording a new cap version; earlier versions are kept and never modified, and the newest version wins where they overlap. The new version applies from `effectiveFrom` (default now) and its periods are anchored on that day of the month. Select the currency with `creditsCurrencyId` in the body; it may be omitted only when the organization has exactly one credits currency. A cap on the customer's root unit is the customer-wide cap. `404` when the customer or the unit does not exist. `409` for customers on seat-based billing. Addresses the customer by your external customer id.
+     * Sets the cap on this customer unit for one credits currency. Returns `changed: false` without creating a version when the effective timeline is unchanged; otherwise records a new version, preserving earlier rows. The newest version wins where they overlap. `effectiveFrom` controls applicability; `schedule` defines monthly UTC boundaries independently. Omit schedule to inherit the version covering effectiveFrom, or use the creation-time UTC day if none applies. Select the currency with `creditsCurrencyId` in the body; it may be omitted only when the organization has exactly one credits currency. A cap covers the unit and every unit beneath it, so a cap on the customer's root unit covers every unit of that customer; spend from a signal that names no unit counts toward no cap. `404` when the customer or the unit does not exist. `409` for customers on seat-based billing, a deleted unit (`CUSTOMER_UNIT_DELETED`) or a draft (`CUSTOMER_UNIT_DRAFT`). Addresses the customer by your external customer id.
      *
      * @param {Paid.SetCustomerUnitCapByExternalIdRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -703,6 +1129,28 @@ export declare class Customers {
      */
     endCustomerUnitCapByExternalId(request: Paid.EndCustomerUnitCapByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnitCapEndResponse>;
     private __endCustomerUnitCapByExternalId;
+    /**
+     * Returns the credits of one credits currency spent by this customer unit and every unit beneath it during a window, whether or not the unit has a cap. The window runs from `start` (inclusive) to `end` (exclusive), at most 366 days; omit both for the current calendar month (UTC). For a capped unit over its cap's current period, `spent` equals the cap's `used`. Spend from a signal that names no unit counts toward no unit. Select the currency with `creditsCurrencyId`; it may be omitted only when the organization has exactly one credits currency, which is then used and echoed back. `404` when the customer or the unit does not exist. Addresses the customer by your external customer id.
+     *
+     * @param {Paid.GetCustomerUnitSpendByExternalIdRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.getCustomerUnitSpendByExternalId({
+     *         externalId: "customer_123",
+     *         externalCustomerUnitId: "tenant-a",
+     *         creditsCurrencyId: "7f4f5d4c-55e9-4d5b-a3e7-c9eb3d2d01bf",
+     *         start: "2026-10-01T00:00:00Z",
+     *         end: "2026-11-01T00:00:00Z"
+     *     })
+     */
+    getCustomerUnitSpendByExternalId(request: Paid.GetCustomerUnitSpendByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnitSpendResponse>;
+    private __getCustomerUnitSpendByExternalId;
     /**
      * Returns the cap in force on this customer unit for one credits currency, with usage in the current period when available. Select the currency with `creditsCurrencyId`; it may be omitted only when the organization has exactly one credits currency, which is then used and echoed back. `404` when the customer or the unit does not exist, or the unit has no cap in force for that currency. The usage figures are advisory: other spend may land between this read and the next burn. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
      *
@@ -724,7 +1172,7 @@ export declare class Customers {
     getCustomerUnitCap(request: Paid.GetCustomerUnitCapRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnitCapResponse>;
     private __getCustomerUnitCap;
     /**
-     * Sets the cap on this customer unit for one credits currency by recording a new cap version; earlier versions are kept and never modified, and the newest version wins where they overlap. The new version applies from `effectiveFrom` (default now) and its periods are anchored on that day of the month. Select the currency with `creditsCurrencyId` in the body; it may be omitted only when the organization has exactly one credits currency. A cap on the customer's root unit is the customer-wide cap. `404` when the customer or the unit does not exist. `409` for customers on seat-based billing. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
+     * Sets the cap on this customer unit for one credits currency. Returns `changed: false` without creating a version when the effective timeline is unchanged; otherwise records a new version, preserving earlier rows. The newest version wins where they overlap. `effectiveFrom` controls applicability; `schedule` defines monthly UTC boundaries independently. Omit schedule to inherit the version covering effectiveFrom, or use the creation-time UTC day if none applies. Select the currency with `creditsCurrencyId` in the body; it may be omitted only when the organization has exactly one credits currency. A cap covers the unit and every unit beneath it, so a cap on the customer's root unit covers every unit of that customer; spend from a signal that names no unit counts toward no cap. `404` when the customer or the unit does not exist. `409` for customers on seat-based billing, a deleted unit (`CUSTOMER_UNIT_DELETED`) or a draft (`CUSTOMER_UNIT_DRAFT`). Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
      *
      * @param {Paid.SetCustomerUnitCapRequest} request
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -767,5 +1215,27 @@ export declare class Customers {
      */
     endCustomerUnitCap(request: Paid.EndCustomerUnitCapRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnitCapEndResponse>;
     private __endCustomerUnitCap;
+    /**
+     * Returns the credits of one credits currency spent by this customer unit and every unit beneath it during a window, whether or not the unit has a cap. The window runs from `start` (inclusive) to `end` (exclusive), at most 366 days; omit both for the current calendar month (UTC). For a capped unit over its cap's current period, `spent` equals the cap's `used`. Spend from a signal that names no unit counts toward no unit. Select the currency with `creditsCurrencyId`; it may be omitted only when the organization has exactly one credits currency, which is then used and echoed back. `404` when the customer or the unit does not exist. Use the value returned as `customer.id`, for example `cus_abc123`; if you have your own customer ID, use the `/api/v2/customers/external/{externalId}/…` twin.
+     *
+     * @param {Paid.GetCustomerUnitSpendRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     * @throws {@link Paid.InternalServerError}
+     *
+     * @example
+     *     await client.customers.getCustomerUnitSpend({
+     *         id: "cus_abc123",
+     *         externalCustomerUnitId: "tenant-a",
+     *         creditsCurrencyId: "7f4f5d4c-55e9-4d5b-a3e7-c9eb3d2d01bf",
+     *         start: "2026-10-01T00:00:00Z",
+     *         end: "2026-11-01T00:00:00Z"
+     *     })
+     */
+    getCustomerUnitSpend(request: Paid.GetCustomerUnitSpendRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomerUnitSpendResponse>;
+    private __getCustomerUnitSpend;
     protected _getAuthorizationHeader(): Promise<string>;
 }