@unkey/api 2.1.0 → 2.1.1

package/src/models/components/v2keysmigratekeysrequestbody.ts

@@ -0,0 +1,73 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  V2KeysMigrateKeyData,
+  V2KeysMigrateKeyData$inboundSchema,
+  V2KeysMigrateKeyData$Outbound,
+  V2KeysMigrateKeyData$outboundSchema,
+} from "./v2keysmigratekeydata.js";
+
+export type V2KeysMigrateKeysRequestBody = {
+  /**
+   * Identifier of the configured migration provider/strategy to use (e.g., "your_company").
+   */
+  migrationId: string;
+  /**
+   * The ID of the API that the keys should be inserted into
+   */
+  apiId: string;
+  keys: Array<V2KeysMigrateKeyData>;
+};
+
+/** @internal */
+export const V2KeysMigrateKeysRequestBody$inboundSchema: z.ZodType<
+  V2KeysMigrateKeysRequestBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  migrationId: z.string(),
+  apiId: z.string(),
+  keys: z.array(V2KeysMigrateKeyData$inboundSchema),
+});
+/** @internal */
+export type V2KeysMigrateKeysRequestBody$Outbound = {
+  migrationId: string;
+  apiId: string;
+  keys: Array<V2KeysMigrateKeyData$Outbound>;
+};
+
+/** @internal */
+export const V2KeysMigrateKeysRequestBody$outboundSchema: z.ZodType<
+  V2KeysMigrateKeysRequestBody$Outbound,
+  z.ZodTypeDef,
+  V2KeysMigrateKeysRequestBody
+> = z.object({
+  migrationId: z.string(),
+  apiId: z.string(),
+  keys: z.array(V2KeysMigrateKeyData$outboundSchema),
+});
+
+export function v2KeysMigrateKeysRequestBodyToJSON(
+  v2KeysMigrateKeysRequestBody: V2KeysMigrateKeysRequestBody,
+): string {
+  return JSON.stringify(
+    V2KeysMigrateKeysRequestBody$outboundSchema.parse(
+      v2KeysMigrateKeysRequestBody,
+    ),
+  );
+}
+export function v2KeysMigrateKeysRequestBodyFromJSON(
+  jsonString: string,
+): SafeParseResult<V2KeysMigrateKeysRequestBody, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => V2KeysMigrateKeysRequestBody$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'V2KeysMigrateKeysRequestBody' from JSON`,
+  );
+}

package/src/models/components/v2keysmigratekeysresponsebody.ts

@@ -0,0 +1,72 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  Meta,
+  Meta$inboundSchema,
+  Meta$Outbound,
+  Meta$outboundSchema,
+} from "./meta.js";
+import {
+  V2KeysMigrateKeysResponseData,
+  V2KeysMigrateKeysResponseData$inboundSchema,
+  V2KeysMigrateKeysResponseData$Outbound,
+  V2KeysMigrateKeysResponseData$outboundSchema,
+} from "./v2keysmigratekeysresponsedata.js";
+
+export type V2KeysMigrateKeysResponseBody = {
+  /**
+   * Metadata object included in every API response. This provides context about the request and is essential for debugging, audit trails, and support inquiries. The `requestId` is particularly important when troubleshooting issues with the Unkey support team.
+   */
+  meta: Meta;
+  data: V2KeysMigrateKeysResponseData;
+};
+
+/** @internal */
+export const V2KeysMigrateKeysResponseBody$inboundSchema: z.ZodType<
+  V2KeysMigrateKeysResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  meta: Meta$inboundSchema,
+  data: V2KeysMigrateKeysResponseData$inboundSchema,
+});
+/** @internal */
+export type V2KeysMigrateKeysResponseBody$Outbound = {
+  meta: Meta$Outbound;
+  data: V2KeysMigrateKeysResponseData$Outbound;
+};
+
+/** @internal */
+export const V2KeysMigrateKeysResponseBody$outboundSchema: z.ZodType<
+  V2KeysMigrateKeysResponseBody$Outbound,
+  z.ZodTypeDef,
+  V2KeysMigrateKeysResponseBody
+> = z.object({
+  meta: Meta$outboundSchema,
+  data: V2KeysMigrateKeysResponseData$outboundSchema,
+});
+
+export function v2KeysMigrateKeysResponseBodyToJSON(
+  v2KeysMigrateKeysResponseBody: V2KeysMigrateKeysResponseBody,
+): string {
+  return JSON.stringify(
+    V2KeysMigrateKeysResponseBody$outboundSchema.parse(
+      v2KeysMigrateKeysResponseBody,
+    ),
+  );
+}
+export function v2KeysMigrateKeysResponseBodyFromJSON(
+  jsonString: string,
+): SafeParseResult<V2KeysMigrateKeysResponseBody, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => V2KeysMigrateKeysResponseBody$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'V2KeysMigrateKeysResponseBody' from JSON`,
+  );
+}

package/src/models/components/v2keysmigratekeysresponsedata.ts

@@ -0,0 +1,69 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  V2KeysMigrateKeysMigration,
+  V2KeysMigrateKeysMigration$inboundSchema,
+  V2KeysMigrateKeysMigration$Outbound,
+  V2KeysMigrateKeysMigration$outboundSchema,
+} from "./v2keysmigratekeysmigration.js";
+
+export type V2KeysMigrateKeysResponseData = {
+  /**
+   * Successfully migrated keys with their hash and generated keyId
+   */
+  migrated: Array<V2KeysMigrateKeysMigration>;
+  /**
+   * Hashes that could not be migrated (e.g., already exist in the system)
+   */
+  failed: Array<string>;
+};
+
+/** @internal */
+export const V2KeysMigrateKeysResponseData$inboundSchema: z.ZodType<
+  V2KeysMigrateKeysResponseData,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  migrated: z.array(V2KeysMigrateKeysMigration$inboundSchema),
+  failed: z.array(z.string()),
+});
+/** @internal */
+export type V2KeysMigrateKeysResponseData$Outbound = {
+  migrated: Array<V2KeysMigrateKeysMigration$Outbound>;
+  failed: Array<string>;
+};
+
+/** @internal */
+export const V2KeysMigrateKeysResponseData$outboundSchema: z.ZodType<
+  V2KeysMigrateKeysResponseData$Outbound,
+  z.ZodTypeDef,
+  V2KeysMigrateKeysResponseData
+> = z.object({
+  migrated: z.array(V2KeysMigrateKeysMigration$outboundSchema),
+  failed: z.array(z.string()),
+});
+
+export function v2KeysMigrateKeysResponseDataToJSON(
+  v2KeysMigrateKeysResponseData: V2KeysMigrateKeysResponseData,
+): string {
+  return JSON.stringify(
+    V2KeysMigrateKeysResponseData$outboundSchema.parse(
+      v2KeysMigrateKeysResponseData,
+    ),
+  );
+}
+export function v2KeysMigrateKeysResponseDataFromJSON(
+  jsonString: string,
+): SafeParseResult<V2KeysMigrateKeysResponseData, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => V2KeysMigrateKeysResponseData$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'V2KeysMigrateKeysResponseData' from JSON`,
+  );
+}

package/src/models/components/v2keysverifykeyrequestbody.ts

@@ -65,6 +65,10 @@ export type V2KeysVerifyKeyRequestBody = {
    * Rate limit checks are optimized for performance but may allow brief bursts during high concurrency.
    */
   ratelimits?: Array<KeysVerifyKeyRatelimit> | undefined;
+  /**
+   * Migrate keys on demand from your previous system. Reach out for migration support at support@unkey.dev
+   */
+  migrationId?: string | undefined;
 };
 
 /** @internal */
@@ -78,6 +82,7 @@ export const V2KeysVerifyKeyRequestBody$inboundSchema: z.ZodType<
   permissions: z.string().optional(),
   credits: KeysVerifyKeyCredits$inboundSchema.optional(),
   ratelimits: z.array(KeysVerifyKeyRatelimit$inboundSchema).optional(),
+  migrationId: z.string().optional(),
 });
 /** @internal */
 export type V2KeysVerifyKeyRequestBody$Outbound = {
@@ -86,6 +91,7 @@ export type V2KeysVerifyKeyRequestBody$Outbound = {
   permissions?: string | undefined;
   credits?: KeysVerifyKeyCredits$Outbound | undefined;
   ratelimits?: Array<KeysVerifyKeyRatelimit$Outbound> | undefined;
+  migrationId?: string | undefined;
 };
 
 /** @internal */
@@ -99,6 +105,7 @@ export const V2KeysVerifyKeyRequestBody$outboundSchema: z.ZodType<
   permissions: z.string().optional(),
   credits: KeysVerifyKeyCredits$outboundSchema.optional(),
   ratelimits: z.array(KeysVerifyKeyRatelimit$outboundSchema).optional(),
+  migrationId: z.string().optional(),
 });
 
 export function v2KeysVerifyKeyRequestBodyToJSON(

package/src/models/components/v2keysverifykeyresponsedata.ts

@@ -103,15 +103,15 @@ export type V2KeysVerifyKeyResponseData = {
    * Unix timestamp (in milliseconds) when the key will expire.
    *
    * @remarks
-   * If null or not present, the key has no expiration. You can use this to
+   * If omitted, the key has no expiration. You can use this to
    * warn users about upcoming expirations or to understand the validity period.
    */
   expires?: number | undefined;
   /**
-   * The number of requests/credits remaining for this key. If null
+   * The number of requests/credits remaining for this key. If omitted,
    *
    * @remarks
-   * or not present, the key has unlimited usage. This value decreases with
+   * the key has unlimited usage. This value decreases with
    * each verification (based on the 'cost' parameter) unless explicit credit
    * refills are configured.
    */

package/src/models/components/v2ratelimitmultilimitcheck.ts

@@ -0,0 +1,130 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type V2RatelimitMultiLimitCheck = {
+  /**
+   * The namespace this rate limit result corresponds to. Use this field to correlate the response with the request when checking multiple rate limits.
+   */
+  namespace: string;
+  /**
+   * The identifier this rate limit result corresponds to. Use this field to correlate the response with the request when checking multiple rate limits.
+   */
+  identifier: string;
+  /**
+   * The maximum number of operations allowed within the time window. This reflects either the default limit specified in the request or an override limit if one exists for this identifier.
+   *
+   * @remarks
+   *
+   * This value helps clients understand their total quota for the current window.
+   */
+  limit: number;
+  /**
+   * The number of operations remaining in the current window before the rate limit is exceeded. Applications should use this value to:
+   *
+   * @remarks
+   *
+   * - Implement client-side throttling before hitting limits
+   * - Display usage information to end users
+   * - Trigger alerts when approaching limits
+   * - Adjust request patterns based on available capacity
+   *
+   * When this reaches zero, requests will be rejected until the window resets.
+   */
+  remaining: number;
+  /**
+   * The Unix timestamp in milliseconds when the rate limit window will reset and 'remaining' will return to 'limit'.
+   *
+   * @remarks
+   *
+   * This timestamp enables clients to:
+   * - Calculate and display wait times to users
+   * - Implement intelligent retry mechanisms
+   * - Schedule requests to resume after the reset
+   * - Implement exponential backoff when needed
+   *
+   * The reset time is based on a sliding window from the first request in the current window.
+   */
+  reset: number;
+  /**
+   * Whether the request passed the rate limit check. If true, the request is allowed to proceed. If false, the request has exceeded the rate limit and should be blocked or rejected.
+   *
+   * @remarks
+   *
+   * You MUST check this field to determine if the request should proceed, as the endpoint always returns `HTTP 200` even when rate limited.
+   */
+  passed: boolean;
+  /**
+   * If a rate limit override was applied for this identifier, this field contains the ID of the override that was used. Empty when no override is in effect.
+   *
+   * @remarks
+   *
+   * This can be useful for:
+   * - Debugging which override rule was matched
+   * - Tracking the effects of specific overrides
+   * - Understanding why limits differ from default values
+   */
+  overrideId?: string | undefined;
+};
+
+/** @internal */
+export const V2RatelimitMultiLimitCheck$inboundSchema: z.ZodType<
+  V2RatelimitMultiLimitCheck,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  namespace: z.string(),
+  identifier: z.string(),
+  limit: z.number().int(),
+  remaining: z.number().int(),
+  reset: z.number().int(),
+  passed: z.boolean(),
+  overrideId: z.string().optional(),
+});
+/** @internal */
+export type V2RatelimitMultiLimitCheck$Outbound = {
+  namespace: string;
+  identifier: string;
+  limit: number;
+  remaining: number;
+  reset: number;
+  passed: boolean;
+  overrideId?: string | undefined;
+};
+
+/** @internal */
+export const V2RatelimitMultiLimitCheck$outboundSchema: z.ZodType<
+  V2RatelimitMultiLimitCheck$Outbound,
+  z.ZodTypeDef,
+  V2RatelimitMultiLimitCheck
+> = z.object({
+  namespace: z.string(),
+  identifier: z.string(),
+  limit: z.number().int(),
+  remaining: z.number().int(),
+  reset: z.number().int(),
+  passed: z.boolean(),
+  overrideId: z.string().optional(),
+});
+
+export function v2RatelimitMultiLimitCheckToJSON(
+  v2RatelimitMultiLimitCheck: V2RatelimitMultiLimitCheck,
+): string {
+  return JSON.stringify(
+    V2RatelimitMultiLimitCheck$outboundSchema.parse(v2RatelimitMultiLimitCheck),
+  );
+}
+export function v2RatelimitMultiLimitCheckFromJSON(
+  jsonString: string,
+): SafeParseResult<V2RatelimitMultiLimitCheck, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => V2RatelimitMultiLimitCheck$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'V2RatelimitMultiLimitCheck' from JSON`,
+  );
+}

package/src/models/components/v2ratelimitmultilimitresponsebody.ts

@@ -0,0 +1,75 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  Meta,
+  Meta$inboundSchema,
+  Meta$Outbound,
+  Meta$outboundSchema,
+} from "./meta.js";
+import {
+  V2RatelimitMultiLimitResponseData,
+  V2RatelimitMultiLimitResponseData$inboundSchema,
+  V2RatelimitMultiLimitResponseData$Outbound,
+  V2RatelimitMultiLimitResponseData$outboundSchema,
+} from "./v2ratelimitmultilimitresponsedata.js";
+
+export type V2RatelimitMultiLimitResponseBody = {
+  /**
+   * Metadata object included in every API response. This provides context about the request and is essential for debugging, audit trails, and support inquiries. The `requestId` is particularly important when troubleshooting issues with the Unkey support team.
+   */
+  meta: Meta;
+  /**
+   * Container for multi-limit rate limit check results
+   */
+  data: V2RatelimitMultiLimitResponseData;
+};
+
+/** @internal */
+export const V2RatelimitMultiLimitResponseBody$inboundSchema: z.ZodType<
+  V2RatelimitMultiLimitResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  meta: Meta$inboundSchema,
+  data: V2RatelimitMultiLimitResponseData$inboundSchema,
+});
+/** @internal */
+export type V2RatelimitMultiLimitResponseBody$Outbound = {
+  meta: Meta$Outbound;
+  data: V2RatelimitMultiLimitResponseData$Outbound;
+};
+
+/** @internal */
+export const V2RatelimitMultiLimitResponseBody$outboundSchema: z.ZodType<
+  V2RatelimitMultiLimitResponseBody$Outbound,
+  z.ZodTypeDef,
+  V2RatelimitMultiLimitResponseBody
+> = z.object({
+  meta: Meta$outboundSchema,
+  data: V2RatelimitMultiLimitResponseData$outboundSchema,
+});
+
+export function v2RatelimitMultiLimitResponseBodyToJSON(
+  v2RatelimitMultiLimitResponseBody: V2RatelimitMultiLimitResponseBody,
+): string {
+  return JSON.stringify(
+    V2RatelimitMultiLimitResponseBody$outboundSchema.parse(
+      v2RatelimitMultiLimitResponseBody,
+    ),
+  );
+}
+export function v2RatelimitMultiLimitResponseBodyFromJSON(
+  jsonString: string,
+): SafeParseResult<V2RatelimitMultiLimitResponseBody, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => V2RatelimitMultiLimitResponseBody$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'V2RatelimitMultiLimitResponseBody' from JSON`,
+  );
+}

package/src/models/components/v2ratelimitmultilimitresponsedata.ts

@@ -0,0 +1,76 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  V2RatelimitMultiLimitCheck,
+  V2RatelimitMultiLimitCheck$inboundSchema,
+  V2RatelimitMultiLimitCheck$Outbound,
+  V2RatelimitMultiLimitCheck$outboundSchema,
+} from "./v2ratelimitmultilimitcheck.js";
+
+/**
+ * Container for multi-limit rate limit check results
+ */
+export type V2RatelimitMultiLimitResponseData = {
+  /**
+   * Overall success indicator for all rate limit checks. This is true if ALL individual rate limit checks passed (all have success: true), and false if ANY check failed.
+   *
+   * @remarks
+   *
+   * Use this as a quick indicator to determine if the request should proceed.
+   */
+  passed: boolean;
+  /**
+   * Array of individual rate limit check results, one for each rate limit check in the request
+   */
+  limits: Array<V2RatelimitMultiLimitCheck>;
+};
+
+/** @internal */
+export const V2RatelimitMultiLimitResponseData$inboundSchema: z.ZodType<
+  V2RatelimitMultiLimitResponseData,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  passed: z.boolean(),
+  limits: z.array(V2RatelimitMultiLimitCheck$inboundSchema),
+});
+/** @internal */
+export type V2RatelimitMultiLimitResponseData$Outbound = {
+  passed: boolean;
+  limits: Array<V2RatelimitMultiLimitCheck$Outbound>;
+};
+
+/** @internal */
+export const V2RatelimitMultiLimitResponseData$outboundSchema: z.ZodType<
+  V2RatelimitMultiLimitResponseData$Outbound,
+  z.ZodTypeDef,
+  V2RatelimitMultiLimitResponseData
+> = z.object({
+  passed: z.boolean(),
+  limits: z.array(V2RatelimitMultiLimitCheck$outboundSchema),
+});
+
+export function v2RatelimitMultiLimitResponseDataToJSON(
+  v2RatelimitMultiLimitResponseData: V2RatelimitMultiLimitResponseData,
+): string {
+  return JSON.stringify(
+    V2RatelimitMultiLimitResponseData$outboundSchema.parse(
+      v2RatelimitMultiLimitResponseData,
+    ),
+  );
+}
+export function v2RatelimitMultiLimitResponseDataFromJSON(
+  jsonString: string,
+): SafeParseResult<V2RatelimitMultiLimitResponseData, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => V2RatelimitMultiLimitResponseData$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'V2RatelimitMultiLimitResponseData' from JSON`,
+  );
+}

package/src/sdk/keys.ts

@@ -7,6 +7,7 @@ import { keysAddRoles } from "../funcs/keysAddRoles.js";
 import { keysCreateKey } from "../funcs/keysCreateKey.js";
 import { keysDeleteKey } from "../funcs/keysDeleteKey.js";
 import { keysGetKey } from "../funcs/keysGetKey.js";
+import { keysMigrateKeys } from "../funcs/keysMigrateKeys.js";
 import { keysRemovePermissions } from "../funcs/keysRemovePermissions.js";
 import { keysRemoveRoles } from "../funcs/keysRemoveRoles.js";
 import { keysRerollKey } from "../funcs/keysRerollKey.js";
@@ -172,6 +173,28 @@ export class Keys extends ClientSDK {
     ));
   }
 
+  /**
+   * Migrate API key(s)
+   *
+   * @remarks
+   * Returns HTTP 200 even on partial success; hashes that could not be migrated are listed under `data.failed`.
+   *
+   * **Required Permissions**
+   * Your root key must have one of the following permissions for basic key information:
+   * - `api.*.create_key` (to migrate keys to any API)
+   * - `api.<api_id>.create_key` (to migrate keys to a specific API)
+   */
+  async migrateKeys(
+    request: components.V2KeysMigrateKeysRequestBody,
+    options?: RequestOptions,
+  ): Promise<components.V2KeysMigrateKeysResponseBody> {
+    return unwrapAsync(keysMigrateKeys(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Remove key permissions
    *

package/src/sdk/ratelimit.ts

@@ -6,6 +6,7 @@ import { ratelimitDeleteOverride } from "../funcs/ratelimitDeleteOverride.js";
 import { ratelimitGetOverride } from "../funcs/ratelimitGetOverride.js";
 import { ratelimitLimit } from "../funcs/ratelimitLimit.js";
 import { ratelimitListOverrides } from "../funcs/ratelimitListOverrides.js";
+import { ratelimitMultiLimit } from "../funcs/ratelimitMultiLimit.js";
 import { ratelimitSetOverride } from "../funcs/ratelimitSetOverride.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as components from "../models/components/index.js";
@@ -73,10 +74,6 @@ export class Ratelimit extends ClientSDK {
    * Your root key must have one of the following permissions:
    * - `ratelimit.*.limit` (to check limits in any namespace)
    * - `ratelimit.<namespace_id>.limit` (to check limits in a specific namespace)
-   *
-   * **Side Effects**
-   *
-   * Records rate limit metrics for analytics and monitoring, updates rate limit counters with sliding window algorithm, and optionally triggers override matching for custom limits.
    */
   async limit(
     request: components.V2RatelimitLimitRequestBody,
@@ -112,6 +109,33 @@ export class Ratelimit extends ClientSDK {
     ));
   }
 
+  /**
+   * Apply multiple rate limit checks
+   *
+   * @remarks
+   * Check and enforce multiple rate limits in a single request for any identifiers (user IDs, IP addresses, API clients, etc.).
+   *
+   * Use this to efficiently check multiple rate limits at once. Each rate limit check is independent and returns its own result with a top-level `passed` indicator showing if all checks succeeded.
+   *
+   * **Response Codes**: Rate limit checks return HTTP 200 regardless of whether limits are exceeded - check the `passed` field to see if all limits passed, or the `success` field in each individual result. 4xx responses indicate auth, namespace existence/deletion, or validation errors (e.g., 410 Gone for deleted namespaces). 5xx responses indicate server errors.
+   *
+   * **Required Permissions**
+   *
+   * Your root key must have one of the following permissions:
+   * - `ratelimit.*.limit` (to check limits in any namespace)
+   * - `ratelimit.<namespace_id>.limit` (to check limits in all specific namespaces being checked)
+   */
+  async multiLimit(
+    request: Array<components.V2RatelimitLimitRequestBody>,
+    options?: RequestOptions,
+  ): Promise<components.V2RatelimitMultiLimitResponseBody> {
+    return unwrapAsync(ratelimitMultiLimit(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Set ratelimit override
    *