@stigg/typescript 0.1.0-beta.60 → 0.1.0-beta.62

package/resources/v1/credits/reservations.d.mts

@@ -0,0 +1,128 @@
+import { APIResource } from "../../../core/resource.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+export declare class Reservations extends APIResource {
+    /**
+     * Releases a credit reservation, consuming the given amount and returning the rest
+     * of the held credits to the balance. Retry a failed release with the same
+     * reservation ID; it is applied once.
+     */
+    release(reservationID: string, params: ReservationReleaseParams, options?: RequestOptions): APIPromise<ReservationReleaseResponse>;
+}
+/**
+ * Response object
+ */
+export interface ReservationReleaseResponse {
+    /**
+     * Result of releasing a credit reservation
+     */
+    data: ReservationReleaseResponse.Data;
+}
+export declare namespace ReservationReleaseResponse {
+    /**
+     * Result of releasing a credit reservation
+     */
+    interface Data {
+        /**
+         * The optimistic credit balance after the release
+         */
+        credit: Data.Credit | null;
+        /**
+         * The released reservation
+         */
+        reservation: Data.Reservation;
+    }
+    namespace Data {
+        /**
+         * The optimistic credit balance after the release
+         */
+        interface Credit {
+            /**
+             * The credit currency identifier
+             */
+            currencyId: string;
+            /**
+             * The wallet's total consumed credits for this currency (optimistic — includes
+             * not-yet-reconciled usage), shared across every feature that draws on the
+             * currency. This is the running balance, not this call's deduction — see
+             * `consumed` for that.
+             */
+            currentUsage: number;
+            /**
+             * The grant-version timestamp of this balance, used by the SDK for last-write-wins
+             * reconciliation
+             */
+            timestamp: string;
+            /**
+             * The total credits granted
+             */
+            usageLimit: number;
+            /**
+             * End of the current credit grant period (when recurring credits reset), if
+             * applicable
+             */
+            usagePeriodEnd?: string | null;
+        }
+        /**
+         * The released reservation
+         */
+        interface Reservation {
+            /**
+             * The client-provided reservation ID.
+             */
+            id: string;
+            /**
+             * The amount of credits held.
+             */
+            amount: number;
+            /**
+             * The amount consumed at release
+             */
+            consumedAmount: number | null;
+            /**
+             * When the reservation expires. Unreleased credits return to the balance at this
+             * time.
+             */
+            expiresAt: string;
+            /**
+             * The status of the reservation.
+             */
+            status: 'ACTIVE' | 'RELEASED';
+        }
+    }
+}
+export interface ReservationReleaseParams {
+    /**
+     * Body param: The amount of credits to consume at release. Up to the reserved
+     * amount is charged to the credits that backed the reservation; the rest returns
+     * to the balance, and any amount above the reservation is consumed normally.
+     */
+    consumedAmount: number;
+    /**
+     * Body param: The credit currency of the reservation
+     */
+    currencyId: string;
+    /**
+     * Body param: The customer the reservation was made for
+     */
+    customerId: string;
+    /**
+     * Body param: The resource the reservation was made for, if any
+     */
+    resourceId?: string;
+    /**
+     * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+     * token); falls back to the user's first membership. Ignored for API-key auth.
+     */
+    'X-ACCOUNT-ID'?: string;
+    /**
+     * Header param: Environment ID — required when authenticating with a user JWT
+     * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+     * intrinsic to the key).
+     */
+    'X-ENVIRONMENT-ID'?: string;
+}
+export declare namespace Reservations {
+    export { type ReservationReleaseResponse as ReservationReleaseResponse, type ReservationReleaseParams as ReservationReleaseParams, };
+}
+//# sourceMappingURL=reservations.d.mts.map

package/resources/v1/credits/reservations.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reservations.d.mts","sourceRoot":"","sources":["../../../src/resources/v1/credits/reservations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,mCAA+B;AACrD,OAAO,EAAE,UAAU,EAAE,sCAAkC;AAEvD,OAAO,EAAE,cAAc,EAAE,8CAA0C;AAGnE,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;OAIG;IACH,OAAO,CACL,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,0BAA0B,CAAC;CAc1C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,0BAA0B,CAAC,IAAI,CAAC;CACvC;AAED,yBAAiB,0BAA0B,CAAC;IAC1C;;OAEG;IACH,UAAiB,IAAI;QACnB;;WAEG;QACH,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QAE3B;;WAEG;QACH,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC;KAC/B;IAED,UAAiB,IAAI,CAAC;QACpB;;WAEG;QACH,UAAiB,MAAM;YACrB;;eAEG;YACH,UAAU,EAAE,MAAM,CAAC;YAEnB;;;;;eAKG;YACH,YAAY,EAAE,MAAM,CAAC;YAErB;;;eAGG;YACH,SAAS,EAAE,MAAM,CAAC;YAElB;;eAEG;YACH,UAAU,EAAE,MAAM,CAAC;YAEnB;;;eAGG;YACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SAChC;QAED;;WAEG;QACH,UAAiB,WAAW;YAC1B;;eAEG;YACH,EAAE,EAAE,MAAM,CAAC;YAEX;;eAEG;YACH,MAAM,EAAE,MAAM,CAAC;YAEf;;eAEG;YACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;YAE9B;;;eAGG;YACH,SAAS,EAAE,MAAM,CAAC;YAElB;;eAEG;YACH,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;SAC/B;KACF;CACF;AAED,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EACL,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}

package/resources/v1/credits/reservations.d.ts

@@ -0,0 +1,128 @@
+import { APIResource } from "../../../core/resource.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+export declare class Reservations extends APIResource {
+    /**
+     * Releases a credit reservation, consuming the given amount and returning the rest
+     * of the held credits to the balance. Retry a failed release with the same
+     * reservation ID; it is applied once.
+     */
+    release(reservationID: string, params: ReservationReleaseParams, options?: RequestOptions): APIPromise<ReservationReleaseResponse>;
+}
+/**
+ * Response object
+ */
+export interface ReservationReleaseResponse {
+    /**
+     * Result of releasing a credit reservation
+     */
+    data: ReservationReleaseResponse.Data;
+}
+export declare namespace ReservationReleaseResponse {
+    /**
+     * Result of releasing a credit reservation
+     */
+    interface Data {
+        /**
+         * The optimistic credit balance after the release
+         */
+        credit: Data.Credit | null;
+        /**
+         * The released reservation
+         */
+        reservation: Data.Reservation;
+    }
+    namespace Data {
+        /**
+         * The optimistic credit balance after the release
+         */
+        interface Credit {
+            /**
+             * The credit currency identifier
+             */
+            currencyId: string;
+            /**
+             * The wallet's total consumed credits for this currency (optimistic — includes
+             * not-yet-reconciled usage), shared across every feature that draws on the
+             * currency. This is the running balance, not this call's deduction — see
+             * `consumed` for that.
+             */
+            currentUsage: number;
+            /**
+             * The grant-version timestamp of this balance, used by the SDK for last-write-wins
+             * reconciliation
+             */
+            timestamp: string;
+            /**
+             * The total credits granted
+             */
+            usageLimit: number;
+            /**
+             * End of the current credit grant period (when recurring credits reset), if
+             * applicable
+             */
+            usagePeriodEnd?: string | null;
+        }
+        /**
+         * The released reservation
+         */
+        interface Reservation {
+            /**
+             * The client-provided reservation ID.
+             */
+            id: string;
+            /**
+             * The amount of credits held.
+             */
+            amount: number;
+            /**
+             * The amount consumed at release
+             */
+            consumedAmount: number | null;
+            /**
+             * When the reservation expires. Unreleased credits return to the balance at this
+             * time.
+             */
+            expiresAt: string;
+            /**
+             * The status of the reservation.
+             */
+            status: 'ACTIVE' | 'RELEASED';
+        }
+    }
+}
+export interface ReservationReleaseParams {
+    /**
+     * Body param: The amount of credits to consume at release. Up to the reserved
+     * amount is charged to the credits that backed the reservation; the rest returns
+     * to the balance, and any amount above the reservation is consumed normally.
+     */
+    consumedAmount: number;
+    /**
+     * Body param: The credit currency of the reservation
+     */
+    currencyId: string;
+    /**
+     * Body param: The customer the reservation was made for
+     */
+    customerId: string;
+    /**
+     * Body param: The resource the reservation was made for, if any
+     */
+    resourceId?: string;
+    /**
+     * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+     * token); falls back to the user's first membership. Ignored for API-key auth.
+     */
+    'X-ACCOUNT-ID'?: string;
+    /**
+     * Header param: Environment ID — required when authenticating with a user JWT
+     * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+     * intrinsic to the key).
+     */
+    'X-ENVIRONMENT-ID'?: string;
+}
+export declare namespace Reservations {
+    export { type ReservationReleaseResponse as ReservationReleaseResponse, type ReservationReleaseParams as ReservationReleaseParams, };
+}
+//# sourceMappingURL=reservations.d.ts.map

package/resources/v1/credits/reservations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reservations.d.ts","sourceRoot":"","sources":["../../../src/resources/v1/credits/reservations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,kCAA+B;AACrD,OAAO,EAAE,UAAU,EAAE,qCAAkC;AAEvD,OAAO,EAAE,cAAc,EAAE,6CAA0C;AAGnE,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;OAIG;IACH,OAAO,CACL,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,0BAA0B,CAAC;CAc1C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,0BAA0B,CAAC,IAAI,CAAC;CACvC;AAED,yBAAiB,0BAA0B,CAAC;IAC1C;;OAEG;IACH,UAAiB,IAAI;QACnB;;WAEG;QACH,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QAE3B;;WAEG;QACH,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC;KAC/B;IAED,UAAiB,IAAI,CAAC;QACpB;;WAEG;QACH,UAAiB,MAAM;YACrB;;eAEG;YACH,UAAU,EAAE,MAAM,CAAC;YAEnB;;;;;eAKG;YACH,YAAY,EAAE,MAAM,CAAC;YAErB;;;eAGG;YACH,SAAS,EAAE,MAAM,CAAC;YAElB;;eAEG;YACH,UAAU,EAAE,MAAM,CAAC;YAEnB;;;eAGG;YACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SAChC;QAED;;WAEG;QACH,UAAiB,WAAW;YAC1B;;eAEG;YACH,EAAE,EAAE,MAAM,CAAC;YAEX;;eAEG;YACH,MAAM,EAAE,MAAM,CAAC;YAEf;;eAEG;YACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;YAE9B;;;eAGG;YACH,SAAS,EAAE,MAAM,CAAC;YAElB;;eAEG;YACH,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;SAC/B;KACF;CACF;AAED,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EACL,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}

package/resources/v1/credits/reservations.js

@@ -0,0 +1,30 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Reservations = void 0;
+const resource_1 = require("../../../core/resource.js");
+const headers_1 = require("../../../internal/headers.js");
+const path_1 = require("../../../internal/utils/path.js");
+class Reservations extends resource_1.APIResource {
+    /**
+     * Releases a credit reservation, consuming the given amount and returning the rest
+     * of the held credits to the balance. Retry a failed release with the same
+     * reservation ID; it is applied once.
+     */
+    release(reservationID, params, options) {
+        const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
+        return this._client.post((0, path_1.path) `/api/v1/credits/reservations/${reservationID}/release`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                {
+                    ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+                    ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.Reservations = Reservations;
+//# sourceMappingURL=reservations.js.map

package/resources/v1/credits/reservations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reservations.js","sourceRoot":"","sources":["../../../src/resources/v1/credits/reservations.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAErD,0DAAyD;AAEzD,0DAAoD;AAEpD,MAAa,YAAa,SAAQ,sBAAW;IAC3C;;;;OAIG;IACH,OAAO,CACL,aAAqB,EACrB,MAAgC,EAChC,OAAwB;QAExB,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC3F,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,gCAAgC,aAAa,UAAU,EAAE;YACpF,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB;oBACE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBACpE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;iBACjF;gBACD,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF;AAxBD,oCAwBC"}

package/resources/v1/credits/reservations.mjs

@@ -0,0 +1,26 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import { buildHeaders } from "../../../internal/headers.mjs";
+import { path } from "../../../internal/utils/path.mjs";
+export class Reservations extends APIResource {
+    /**
+     * Releases a credit reservation, consuming the given amount and returning the rest
+     * of the held credits to the balance. Retry a failed release with the same
+     * reservation ID; it is applied once.
+     */
+    release(reservationID, params, options) {
+        const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
+        return this._client.post(path `/api/v1/credits/reservations/${reservationID}/release`, {
+            body,
+            ...options,
+            headers: buildHeaders([
+                {
+                    ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+                    ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+}
+//# sourceMappingURL=reservations.mjs.map

package/resources/v1/credits/reservations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reservations.mjs","sourceRoot":"","sources":["../../../src/resources/v1/credits/reservations.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAErD,OAAO,EAAE,YAAY,EAAE,sCAAkC;AAEzD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C;;;;OAIG;IACH,OAAO,CACL,aAAqB,EACrB,MAAgC,EAChC,OAAwB;QAExB,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC3F,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,gCAAgC,aAAa,UAAU,EAAE;YACpF,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB;oBACE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBACpE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;iBACjF;gBACD,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -882,6 +882,22 @@ export declare namespace CustomerCheckEntitlementResponse {
          * Timestamp of the last update to the entitlement grant or configuration.
          */
         entitlementUpdatedAt?: string;
+        /**
+         * The reservation created by this request, when it asked to reserve credits and
+         * was granted.
+         */
+        reservation?: Credit.Reservation | null;
+        /**
+         * Credits held by open reservations on active grants. Already included in
+         * currentUsage, so usageLimit - currentUsage is the available balance.
+         */
+        reserved?: number;
+        /**
+         * Credits still held by open reservations on grants that expired during the hold.
+         * They can still be released, but are not part of currentUsage or the balance and
+         * must not be subtracted from it.
+         */
+        reservedOnExpiredGrants?: number;
         /**
          * The end date of the current billing period for recurring credit grants.
          */
@@ -923,6 +939,29 @@ export declare namespace CustomerCheckEntitlementResponse {
              */
             unitSingular?: string | null;
         }
+        /**
+         * The reservation created by this request, when it asked to reserve credits and
+         * was granted.
+         */
+        interface Reservation {
+            /**
+             * The client-provided reservation ID.
+             */
+            id: string;
+            /**
+             * The amount of credits held.
+             */
+            amount: number;
+            /**
+             * When the reservation expires. Unreleased credits return to the balance at this
+             * time.
+             */
+            expiresAt: string;
+            /**
+             * The status of the reservation.
+             */
+            status: 'ACTIVE' | 'RELEASED';
+        }
     }
 }
 /**
@@ -1340,6 +1379,22 @@ export declare namespace CustomerRetrieveEntitlementsResponse {
              * Timestamp of the last update to the entitlement grant or configuration.
              */
             entitlementUpdatedAt?: string;
+            /**
+             * The reservation created by this request, when it asked to reserve credits and
+             * was granted.
+             */
+            reservation?: Credit.Reservation | null;
+            /**
+             * Credits held by open reservations on active grants. Already included in
+             * currentUsage, so usageLimit - currentUsage is the available balance.
+             */
+            reserved?: number;
+            /**
+             * Credits still held by open reservations on grants that expired during the hold.
+             * They can still be released, but are not part of currentUsage or the balance and
+             * must not be subtracted from it.
+             */
+            reservedOnExpiredGrants?: number;
             /**
              * The end date of the current billing period for recurring credit grants.
              */
@@ -1381,6 +1436,29 @@ export declare namespace CustomerRetrieveEntitlementsResponse {
                  */
                 unitSingular?: string | null;
             }
+            /**
+             * The reservation created by this request, when it asked to reserve credits and
+             * was granted.
+             */
+            interface Reservation {
+                /**
+                 * The client-provided reservation ID.
+                 */
+                id: string;
+                /**
+                 * The amount of credits held.
+                 */
+                amount: number;
+                /**
+                 * When the reservation expires. Unreleased credits return to the balance at this
+                 * time.
+                 */
+                expiresAt: string;
+                /**
+                 * The status of the reservation.
+                 */
+                status: 'ACTIVE' | 'RELEASED';
+            }
         }
     }
 }
@@ -1743,6 +1821,31 @@ export interface CustomerCheckEntitlementParams {
      * only)
      */
     requestedValues?: Array<string>;
+    /**
+     * Query param: When the reservation expires (ISO 8601, at most 24 hours ahead).
+     * Mutually exclusive with `reservationTtlSeconds`.
+     */
+    reservationExpiresAt?: string;
+    /**
+     * Query param: Client-provided reservation ID, required with `reserveAmount`.
+     * Retry with the same ID to get the same result; reuse with different parameters
+     * is a conflict.
+     */
+    reservationId?: string;
+    /**
+     * Query param: JSON-encoded object of string values to attach to the reservation.
+     */
+    reservationMetadata?: string;
+    /**
+     * Query param: How long the reservation holds the credits, in seconds (1–86400,
+     * default 3600). Mutually exclusive with `reservationExpiresAt`.
+     */
+    reservationTtlSeconds?: number;
+    /**
+     * Query param: Credits to reserve (credit entitlements only). The check is decided
+     * and the credits held atomically; `requestedUsage` is ignored.
+     */
+    reserveAmount?: number;
     /**
      * Query param: Resource ID to scope the entitlement check to a specific resource
      */