telnyx 7.28.0 → 7.29.0

package/resources/public-internet-gateways.d.ts.map

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

package/resources/spend-limits.d.mts

@@ -1,4 +1,5 @@
 import { APIResource } from "../core/resource.mjs";
+import * as SpendLimitsAPI from "./spend-limits.mjs";
 import { APIPromise } from "../core/api-promise.mjs";
 import { RequestOptions } from "../internal/request-options.mjs";
 /**
@@ -8,6 +9,7 @@ import { RequestOptions } from "../internal/request-options.mjs";
  * - **Blocking.** When spend in a period goes above the limit (strictly greater), the product is blocked until the period ends: 00:00 UTC the next day for `daily`, 00:00 UTC on the 1st of the next month for `monthly`. A block appears within about 2 minutes (daily) or 10 minutes (monthly) of the spend being recorded.
  * - **Changes apply immediately.** Creating, updating or deleting a limit checks the period's spend in the same request: raising the limit above the spend, or removing it, lifts that period's block, and lowering it below the spend blocks the product at once. The `evaluation` object in the response says what happened.
  * - **Supported products.** Today only `inference` supports spend limits. A blocked account gets HTTP 403 with the error title `Inference spend limit reached` (code `10039`) on new billable chat completions, Responses, Anthropic Messages and classification requests; requests already running finish normally. Take the list of products from the list operation.
+ * - **API key limits.** For `inference`, a limit can also apply to one API key, named by `credential_id`: the key's identifier as recorded on usage, never its secret. When the key's spend goes above its own limit, only that key is blocked, with the error title `API key spend limit reached` (code `10039`); the account's other keys keep working. The API key limits of a period cannot add up to more than the total limit when the total has an amount. Only language-model requests authenticated with an API key count toward its limit.
  * - **Limits set by Telnyx.** Telnyx support can also set a limit on your account. It is listed with `origin: operator` and you can update or delete it like your own.
  */
 export declare class SpendLimits extends APIResource {
@@ -16,7 +18,9 @@ export declare class SpendLimits extends APIResource {
      * the spend so far in the period and whether the product is blocked. An entry
      * without a limit is still listed (`limit: null`). When the spend cannot be read,
      * the entry is returned with `spend_usd: null` and `spend_error` set. The list is
-     * not paginated.
+     * not paginated. Each entry also lists the API key limits of its product and
+     * period in `credential_limits`, with each key's spend and block. Each API key
+     * limit can be at most the total limit; together they may add up to more than it.
      *
      * @example
      * ```ts
@@ -29,7 +33,9 @@ export declare class SpendLimits extends APIResource {
      * `amount` and `unlimited: true`. The period's spend is checked at once: if it is
      * already above the new limit, the product is blocked immediately
      * (`evaluation.blocked_now`). Returns 409 when a limit already exists for the
-     * product and period; update it instead.
+     * product and period; update it instead. With `credential_id`, the limit applies
+     * to that API key only: it needs an `amount`, and the period's API key limits
+     * cannot add up to more than the total limit when the total has an amount.
      *
      * @example
      * ```ts
@@ -47,7 +53,11 @@ export declare class SpendLimits extends APIResource {
      * default limit, the product becomes unlimited for the period and the period's
      * block is lifted (`evaluation.released`). The response carries `limit: null` and
      * the `effective_limit_usd` that applies after the removal. Returns 404 when no
-     * limit is set.
+     * limit is set. With the `credential_id` query parameter, the request removes that
+     * API key's limit for the period and lifts the key's block in that period at once.
+     * A block under the key's limit in the other period stays
+     * (`evaluation.still_blocked_other_period`). Removing the total limit leaves the
+     * API key limits in place.
      *
      * @example
      * ```ts
@@ -63,6 +73,9 @@ export declare class SpendLimits extends APIResource {
      * once: raising the limit above the spend lifts the period's block
      * (`evaluation.released`), and lowering it below the spend blocks the product
      * (`evaluation.blocked_now`). Returns 404 when no limit is set; create it instead.
+     * With the `credential_id` query parameter, the request changes that API key's
+     * limit; it needs an `amount`, and it can be at most the period's total limit.
+     * Lowering the total limit below the period's highest API key limit is refused.
      *
      * @example
      * ```ts
@@ -75,16 +88,19 @@ export declare class SpendLimits extends APIResource {
     update(product: string, params: SpendLimitUpdateParams, options?: RequestOptions): APIPromise<SpendLimitResponse>;
 }
 /**
- * The spend limit, spend and block state of one product and period.
+ * The spend limit, spend and block state of one product and period. The top-level
+ * fields describe the total limit of the account; API key limits are nested in
+ * `credential_limits`.
  */
 export interface SpendLimit {
     /**
      * The active block of the period. `null` when the period is not blocked.
      */
-    block: SpendLimit.Block | null;
+    block: SpendLimitBlock | null;
     /**
-     * The product is blocked for this period. Always `false` in write responses; list
-     * the limits to read the block state.
+     * The product is blocked for the whole account in this period (total limit). An
+     * API key's own block appears only in `credential_limits`. Always `false` in write
+     * responses; list the limits to read the block state.
      */
     blocked: boolean;
     /**
@@ -129,6 +145,17 @@ export interface SpendLimit {
      * by about a minute. `null` when it could not be read.
      */
     spend_usd: string | null;
+    /**
+     * In write responses, the API key the write was about; `null` for the total limit.
+     * Always `null` in list entries, which describe the total limit.
+     */
+    credential_id?: string | null;
+    /**
+     * List responses only. One item per API key limit of the product and period,
+     * sorted by `credential_id`, plus every API key that is still blocked. `[]` when
+     * there are none.
+     */
+    credential_limits?: Array<SpendLimit.CredentialLimit>;
     /**
      * What a create, update or delete did to the period at once. Only present in write
      * responses.
@@ -136,28 +163,6 @@ export interface SpendLimit {
     evaluation?: SpendLimit.Evaluation;
 }
 export declare namespace SpendLimit {
-    /**
-     * The active block of the period. `null` when the period is not blocked.
-     */
-    interface Block {
-        /**
-         * Exclusive end of the block: it is lifted at 00:00 UTC on this date at the
-         * latest.
-         */
-        blocked_until: string;
-        /**
-         * When the block started.
-         */
-        detected_at: string;
-        /**
-         * The limit in USD that the spend went above, as a decimal string.
-         */
-        limit_usd: string;
-        /**
-         * Spend in USD when the block started, as a decimal string.
-         */
-        spend_usd: string;
-    }
     /**
      * The limit set on the account for the product and period, whoever set it. `null`
      * when none is set.
@@ -181,6 +186,65 @@ export declare namespace SpendLimit {
          */
         updated_at: string;
     }
+    /**
+     * The limit, spend and block state of one API key in the product and period.
+     */
+    interface CredentialLimit {
+        /**
+         * The active block of the period. `null` when the period is not blocked.
+         */
+        block: SpendLimitsAPI.SpendLimitBlock | null;
+        /**
+         * This API key is blocked for the period.
+         */
+        blocked: boolean;
+        /**
+         * Identifier of the API key as recorded on usage. Never the key's secret.
+         */
+        credential_id: string;
+        /**
+         * The limit of one API key. It always has an amount. `null` for an API key that is
+         * still blocked after its limit was removed.
+         */
+        limit: CredentialLimit.Limit | null;
+        /**
+         * Set when `spend_usd` is `null`.
+         */
+        spend_error: string | null;
+        /**
+         * Spend in USD in the period made with exactly this API key, as a decimal string.
+         * Usage without an API key identifier, or with another one, counts only toward the
+         * total. `null` when it could not be read.
+         */
+        spend_usd: string | null;
+        /**
+         * The API key's limit is above the period's total limit. Only a change by Telnyx
+         * support can cause it; the total limit still applies to the whole account. Lower
+         * the API key limit or raise the total.
+         */
+        exceeds_total?: boolean;
+    }
+    namespace CredentialLimit {
+        /**
+         * The limit of one API key. It always has an amount. `null` for an API key that is
+         * still blocked after its limit was removed.
+         */
+        interface Limit {
+            /**
+             * Limit in USD, as a decimal string.
+             */
+            amount: string;
+            /**
+             * `self_service` when a user of the account set it, `operator` when Telnyx support
+             * did.
+             */
+            origin: 'self_service' | 'operator';
+            /**
+             * When the limit was last set or changed.
+             */
+            updated_at: string;
+        }
+    }
     /**
      * What a create, update or delete did to the period at once. Only present in write
      * responses.
@@ -206,26 +270,55 @@ export declare namespace SpendLimit {
         spend_usd: string | null;
         /**
          * The other period has an active block, so the product stays blocked whatever this
-         * period's result.
+         * period's result. For an API key write, the API key's limit in the other period.
          */
         still_blocked_other_period: boolean;
         /**
          * A block of this period remains because the spend is still above the new limit.
          */
         still_over_limit: boolean;
+        /**
+         * API key writes only: the account itself remains blocked for the product under a
+         * total limit. Absent for total limit writes.
+         */
+        account_blocked?: boolean;
         /**
          * Additional information about the result, when there is any.
          */
         note?: string;
     }
 }
+/**
+ * The active block of the period. `null` when the period is not blocked.
+ */
+export interface SpendLimitBlock {
+    /**
+     * Exclusive end of the block: it is lifted at 00:00 UTC on this date at the
+     * latest.
+     */
+    blocked_until: string;
+    /**
+     * When the block started.
+     */
+    detected_at: string;
+    /**
+     * The limit in USD that the spend went above, as a decimal string.
+     */
+    limit_usd: string;
+    /**
+     * Spend in USD when the block started, as a decimal string.
+     */
+    spend_usd: string;
+}
 /**
  * `daily` is the current UTC day; `monthly` is the current UTC calendar month.
  */
 export type SpendLimitPeriod = 'daily' | 'monthly';
 export interface SpendLimitResponse {
     /**
-     * The spend limit, spend and block state of one product and period.
+     * The spend limit, spend and block state of one product and period. The top-level
+     * fields describe the total limit of the account; API key limits are nested in
+     * `credential_limits`.
      */
     data: SpendLimit;
 }
@@ -252,6 +345,13 @@ export declare namespace SpendLimitCreateParams {
          * Product to limit, as returned in `product` by the list operation.
          */
         product: string;
+        /**
+         * Optional. Identifier of one API key as recorded on usage, never the key's
+         * secret: the limit then applies to that key only. Absent or `null` sets the total
+         * limit. A blank value, or one with control characters, is refused; it never means
+         * the total limit. An API key limit always has an `amount`.
+         */
+        credential_id?: string | null;
         /**
          * `daily` is the current UTC day; `monthly` is the current UTC calendar month.
          */
@@ -285,6 +385,12 @@ export declare namespace SpendLimitCreateParams {
     }
 }
 export interface SpendLimitDeleteParams {
+    /**
+     * Identifier of one API key as recorded on usage, never the key's secret,
+     * percent-encoded: the request is then about that key's limit. Absent means the
+     * total limit; present but blank is refused.
+     */
+    credential_id?: string;
     /**
      * Limit period. Defaults to `daily`; send it explicitly.
      */
@@ -301,6 +407,12 @@ export declare namespace SpendLimitUpdateParams {
          * Body param: Limit in USD. `0` blocks at the first cent of spend.
          */
         amount: number;
+        /**
+         * Query param: Identifier of one API key as recorded on usage, never the key's
+         * secret, percent-encoded: the request is then about that key's limit. Absent
+         * means the total limit; present but blank is refused.
+         */
+        credential_id?: string;
         /**
          * Query param: Limit period. Defaults to `daily`; send it explicitly.
          */
@@ -319,6 +431,12 @@ export declare namespace SpendLimitUpdateParams {
          * Body param: `true`: explicitly no cap.
          */
         unlimited: true;
+        /**
+         * Query param: Identifier of one API key as recorded on usage, never the key's
+         * secret, percent-encoded: the request is then about that key's limit. Absent
+         * means the total limit; present but blank is refused.
+         */
+        credential_id?: string;
         /**
          * Query param: Limit period. Defaults to `daily`; send it explicitly.
          */
@@ -330,6 +448,6 @@ export declare namespace SpendLimitUpdateParams {
     }
 }
 export declare namespace SpendLimits {
-    export { type SpendLimit as SpendLimit, type SpendLimitPeriod as SpendLimitPeriod, type SpendLimitResponse as SpendLimitResponse, type SpendLimitListResponse as SpendLimitListResponse, type SpendLimitCreateParams as SpendLimitCreateParams, type SpendLimitDeleteParams as SpendLimitDeleteParams, type SpendLimitUpdateParams as SpendLimitUpdateParams, };
+    export { type SpendLimit as SpendLimit, type SpendLimitBlock as SpendLimitBlock, type SpendLimitPeriod as SpendLimitPeriod, type SpendLimitResponse as SpendLimitResponse, type SpendLimitListResponse as SpendLimitListResponse, type SpendLimitCreateParams as SpendLimitCreateParams, type SpendLimitDeleteParams as SpendLimitDeleteParams, type SpendLimitUpdateParams as SpendLimitUpdateParams, };
 }
 //# sourceMappingURL=spend-limits.d.mts.map

package/resources/spend-limits.d.mts.map

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

package/resources/spend-limits.d.ts

@@ -1,4 +1,5 @@
 import { APIResource } from "../core/resource.js";
+import * as SpendLimitsAPI from "./spend-limits.js";
 import { APIPromise } from "../core/api-promise.js";
 import { RequestOptions } from "../internal/request-options.js";
 /**
@@ -8,6 +9,7 @@ import { RequestOptions } from "../internal/request-options.js";
  * - **Blocking.** When spend in a period goes above the limit (strictly greater), the product is blocked until the period ends: 00:00 UTC the next day for `daily`, 00:00 UTC on the 1st of the next month for `monthly`. A block appears within about 2 minutes (daily) or 10 minutes (monthly) of the spend being recorded.
  * - **Changes apply immediately.** Creating, updating or deleting a limit checks the period's spend in the same request: raising the limit above the spend, or removing it, lifts that period's block, and lowering it below the spend blocks the product at once. The `evaluation` object in the response says what happened.
  * - **Supported products.** Today only `inference` supports spend limits. A blocked account gets HTTP 403 with the error title `Inference spend limit reached` (code `10039`) on new billable chat completions, Responses, Anthropic Messages and classification requests; requests already running finish normally. Take the list of products from the list operation.
+ * - **API key limits.** For `inference`, a limit can also apply to one API key, named by `credential_id`: the key's identifier as recorded on usage, never its secret. When the key's spend goes above its own limit, only that key is blocked, with the error title `API key spend limit reached` (code `10039`); the account's other keys keep working. The API key limits of a period cannot add up to more than the total limit when the total has an amount. Only language-model requests authenticated with an API key count toward its limit.
  * - **Limits set by Telnyx.** Telnyx support can also set a limit on your account. It is listed with `origin: operator` and you can update or delete it like your own.
  */
 export declare class SpendLimits extends APIResource {
@@ -16,7 +18,9 @@ export declare class SpendLimits extends APIResource {
      * the spend so far in the period and whether the product is blocked. An entry
      * without a limit is still listed (`limit: null`). When the spend cannot be read,
      * the entry is returned with `spend_usd: null` and `spend_error` set. The list is
-     * not paginated.
+     * not paginated. Each entry also lists the API key limits of its product and
+     * period in `credential_limits`, with each key's spend and block. Each API key
+     * limit can be at most the total limit; together they may add up to more than it.
      *
      * @example
      * ```ts
@@ -29,7 +33,9 @@ export declare class SpendLimits extends APIResource {
      * `amount` and `unlimited: true`. The period's spend is checked at once: if it is
      * already above the new limit, the product is blocked immediately
      * (`evaluation.blocked_now`). Returns 409 when a limit already exists for the
-     * product and period; update it instead.
+     * product and period; update it instead. With `credential_id`, the limit applies
+     * to that API key only: it needs an `amount`, and the period's API key limits
+     * cannot add up to more than the total limit when the total has an amount.
      *
      * @example
      * ```ts
@@ -47,7 +53,11 @@ export declare class SpendLimits extends APIResource {
      * default limit, the product becomes unlimited for the period and the period's
      * block is lifted (`evaluation.released`). The response carries `limit: null` and
      * the `effective_limit_usd` that applies after the removal. Returns 404 when no
-     * limit is set.
+     * limit is set. With the `credential_id` query parameter, the request removes that
+     * API key's limit for the period and lifts the key's block in that period at once.
+     * A block under the key's limit in the other period stays
+     * (`evaluation.still_blocked_other_period`). Removing the total limit leaves the
+     * API key limits in place.
      *
      * @example
      * ```ts
@@ -63,6 +73,9 @@ export declare class SpendLimits extends APIResource {
      * once: raising the limit above the spend lifts the period's block
      * (`evaluation.released`), and lowering it below the spend blocks the product
      * (`evaluation.blocked_now`). Returns 404 when no limit is set; create it instead.
+     * With the `credential_id` query parameter, the request changes that API key's
+     * limit; it needs an `amount`, and it can be at most the period's total limit.
+     * Lowering the total limit below the period's highest API key limit is refused.
      *
      * @example
      * ```ts
@@ -75,16 +88,19 @@ export declare class SpendLimits extends APIResource {
     update(product: string, params: SpendLimitUpdateParams, options?: RequestOptions): APIPromise<SpendLimitResponse>;
 }
 /**
- * The spend limit, spend and block state of one product and period.
+ * The spend limit, spend and block state of one product and period. The top-level
+ * fields describe the total limit of the account; API key limits are nested in
+ * `credential_limits`.
  */
 export interface SpendLimit {
     /**
      * The active block of the period. `null` when the period is not blocked.
      */
-    block: SpendLimit.Block | null;
+    block: SpendLimitBlock | null;
     /**
-     * The product is blocked for this period. Always `false` in write responses; list
-     * the limits to read the block state.
+     * The product is blocked for the whole account in this period (total limit). An
+     * API key's own block appears only in `credential_limits`. Always `false` in write
+     * responses; list the limits to read the block state.
      */
     blocked: boolean;
     /**
@@ -129,6 +145,17 @@ export interface SpendLimit {
      * by about a minute. `null` when it could not be read.
      */
     spend_usd: string | null;
+    /**
+     * In write responses, the API key the write was about; `null` for the total limit.
+     * Always `null` in list entries, which describe the total limit.
+     */
+    credential_id?: string | null;
+    /**
+     * List responses only. One item per API key limit of the product and period,
+     * sorted by `credential_id`, plus every API key that is still blocked. `[]` when
+     * there are none.
+     */
+    credential_limits?: Array<SpendLimit.CredentialLimit>;
     /**
      * What a create, update or delete did to the period at once. Only present in write
      * responses.
@@ -136,28 +163,6 @@ export interface SpendLimit {
     evaluation?: SpendLimit.Evaluation;
 }
 export declare namespace SpendLimit {
-    /**
-     * The active block of the period. `null` when the period is not blocked.
-     */
-    interface Block {
-        /**
-         * Exclusive end of the block: it is lifted at 00:00 UTC on this date at the
-         * latest.
-         */
-        blocked_until: string;
-        /**
-         * When the block started.
-         */
-        detected_at: string;
-        /**
-         * The limit in USD that the spend went above, as a decimal string.
-         */
-        limit_usd: string;
-        /**
-         * Spend in USD when the block started, as a decimal string.
-         */
-        spend_usd: string;
-    }
     /**
      * The limit set on the account for the product and period, whoever set it. `null`
      * when none is set.
@@ -181,6 +186,65 @@ export declare namespace SpendLimit {
          */
         updated_at: string;
     }
+    /**
+     * The limit, spend and block state of one API key in the product and period.
+     */
+    interface CredentialLimit {
+        /**
+         * The active block of the period. `null` when the period is not blocked.
+         */
+        block: SpendLimitsAPI.SpendLimitBlock | null;
+        /**
+         * This API key is blocked for the period.
+         */
+        blocked: boolean;
+        /**
+         * Identifier of the API key as recorded on usage. Never the key's secret.
+         */
+        credential_id: string;
+        /**
+         * The limit of one API key. It always has an amount. `null` for an API key that is
+         * still blocked after its limit was removed.
+         */
+        limit: CredentialLimit.Limit | null;
+        /**
+         * Set when `spend_usd` is `null`.
+         */
+        spend_error: string | null;
+        /**
+         * Spend in USD in the period made with exactly this API key, as a decimal string.
+         * Usage without an API key identifier, or with another one, counts only toward the
+         * total. `null` when it could not be read.
+         */
+        spend_usd: string | null;
+        /**
+         * The API key's limit is above the period's total limit. Only a change by Telnyx
+         * support can cause it; the total limit still applies to the whole account. Lower
+         * the API key limit or raise the total.
+         */
+        exceeds_total?: boolean;
+    }
+    namespace CredentialLimit {
+        /**
+         * The limit of one API key. It always has an amount. `null` for an API key that is
+         * still blocked after its limit was removed.
+         */
+        interface Limit {
+            /**
+             * Limit in USD, as a decimal string.
+             */
+            amount: string;
+            /**
+             * `self_service` when a user of the account set it, `operator` when Telnyx support
+             * did.
+             */
+            origin: 'self_service' | 'operator';
+            /**
+             * When the limit was last set or changed.
+             */
+            updated_at: string;
+        }
+    }
     /**
      * What a create, update or delete did to the period at once. Only present in write
      * responses.
@@ -206,26 +270,55 @@ export declare namespace SpendLimit {
         spend_usd: string | null;
         /**
          * The other period has an active block, so the product stays blocked whatever this
-         * period's result.
+         * period's result. For an API key write, the API key's limit in the other period.
          */
         still_blocked_other_period: boolean;
         /**
          * A block of this period remains because the spend is still above the new limit.
          */
         still_over_limit: boolean;
+        /**
+         * API key writes only: the account itself remains blocked for the product under a
+         * total limit. Absent for total limit writes.
+         */
+        account_blocked?: boolean;
         /**
          * Additional information about the result, when there is any.
          */
         note?: string;
     }
 }
+/**
+ * The active block of the period. `null` when the period is not blocked.
+ */
+export interface SpendLimitBlock {
+    /**
+     * Exclusive end of the block: it is lifted at 00:00 UTC on this date at the
+     * latest.
+     */
+    blocked_until: string;
+    /**
+     * When the block started.
+     */
+    detected_at: string;
+    /**
+     * The limit in USD that the spend went above, as a decimal string.
+     */
+    limit_usd: string;
+    /**
+     * Spend in USD when the block started, as a decimal string.
+     */
+    spend_usd: string;
+}
 /**
  * `daily` is the current UTC day; `monthly` is the current UTC calendar month.
  */
 export type SpendLimitPeriod = 'daily' | 'monthly';
 export interface SpendLimitResponse {
     /**
-     * The spend limit, spend and block state of one product and period.
+     * The spend limit, spend and block state of one product and period. The top-level
+     * fields describe the total limit of the account; API key limits are nested in
+     * `credential_limits`.
      */
     data: SpendLimit;
 }
@@ -252,6 +345,13 @@ export declare namespace SpendLimitCreateParams {
          * Product to limit, as returned in `product` by the list operation.
          */
         product: string;
+        /**
+         * Optional. Identifier of one API key as recorded on usage, never the key's
+         * secret: the limit then applies to that key only. Absent or `null` sets the total
+         * limit. A blank value, or one with control characters, is refused; it never means
+         * the total limit. An API key limit always has an `amount`.
+         */
+        credential_id?: string | null;
         /**
          * `daily` is the current UTC day; `monthly` is the current UTC calendar month.
          */
@@ -285,6 +385,12 @@ export declare namespace SpendLimitCreateParams {
     }
 }
 export interface SpendLimitDeleteParams {
+    /**
+     * Identifier of one API key as recorded on usage, never the key's secret,
+     * percent-encoded: the request is then about that key's limit. Absent means the
+     * total limit; present but blank is refused.
+     */
+    credential_id?: string;
     /**
      * Limit period. Defaults to `daily`; send it explicitly.
      */
@@ -301,6 +407,12 @@ export declare namespace SpendLimitUpdateParams {
          * Body param: Limit in USD. `0` blocks at the first cent of spend.
          */
         amount: number;
+        /**
+         * Query param: Identifier of one API key as recorded on usage, never the key's
+         * secret, percent-encoded: the request is then about that key's limit. Absent
+         * means the total limit; present but blank is refused.
+         */
+        credential_id?: string;
         /**
          * Query param: Limit period. Defaults to `daily`; send it explicitly.
          */
@@ -319,6 +431,12 @@ export declare namespace SpendLimitUpdateParams {
          * Body param: `true`: explicitly no cap.
          */
         unlimited: true;
+        /**
+         * Query param: Identifier of one API key as recorded on usage, never the key's
+         * secret, percent-encoded: the request is then about that key's limit. Absent
+         * means the total limit; present but blank is refused.
+         */
+        credential_id?: string;
         /**
          * Query param: Limit period. Defaults to `daily`; send it explicitly.
          */
@@ -330,6 +448,6 @@ export declare namespace SpendLimitUpdateParams {
     }
 }
 export declare namespace SpendLimits {
-    export { type SpendLimit as SpendLimit, type SpendLimitPeriod as SpendLimitPeriod, type SpendLimitResponse as SpendLimitResponse, type SpendLimitListResponse as SpendLimitListResponse, type SpendLimitCreateParams as SpendLimitCreateParams, type SpendLimitDeleteParams as SpendLimitDeleteParams, type SpendLimitUpdateParams as SpendLimitUpdateParams, };
+    export { type SpendLimit as SpendLimit, type SpendLimitBlock as SpendLimitBlock, type SpendLimitPeriod as SpendLimitPeriod, type SpendLimitResponse as SpendLimitResponse, type SpendLimitListResponse as SpendLimitListResponse, type SpendLimitCreateParams as SpendLimitCreateParams, type SpendLimitDeleteParams as SpendLimitDeleteParams, type SpendLimitUpdateParams as SpendLimitUpdateParams, };
 }
 //# sourceMappingURL=spend-limits.d.ts.map