@openrouter/sdk 1.4.21 → 1.4.23

package/esm/funcs/byokUpdate.d.ts

@@ -15,5 +15,5 @@ import { Result } from "../types/fp.js";
  * @remarks
  * Update an existing bring-your-own-key (BYOK) provider credential by its `id`. Include the `key` field to rotate the raw provider API key in-place (the previous key material is overwritten). Use `allowed_api_key_hashes` to restrict the credential to specific OpenRouter API keys (`null` clears the restriction). [Management key](/docs/guides/overview/auth/management-api-keys) required.
  */
-export declare function byokUpdate(client: OpenRouterCore, request: operations.UpdateBYOKKeyRequest, options?: RequestOptions): APIPromise<Result<models.UpdateBYOKKeyResponse, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.ForbiddenResponseError | errors.NotFoundResponseError | errors.InternalServerResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+export declare function byokUpdate(client: OpenRouterCore, request: operations.UpdateBYOKKeyRequest, options?: RequestOptions): APIPromise<Result<models.UpdateBYOKKeyResponse, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.ForbiddenResponseError | errors.NotFoundResponseError | errors.ConflictResponseError | errors.InternalServerResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
 //# sourceMappingURL=byokUpdate.d.ts.map

package/esm/funcs/byokUpdate.js

@@ -9,7 +9,7 @@ import { compactMap } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
 import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
 import { pathToFunc } from "../lib/url.js";
-import { BadRequestResponseError$inboundSchema as errors_BadRequestResponseError$inboundSchema } from "../models/errors/badrequestresponseerror.js"; import { ForbiddenResponseError$inboundSchema as errors_ForbiddenResponseError$inboundSchema } from "../models/errors/forbiddenresponseerror.js"; import { InternalServerResponseError$inboundSchema as errors_InternalServerResponseError$inboundSchema } from "../models/errors/internalserverresponseerror.js"; import { NotFoundResponseError$inboundSchema as errors_NotFoundResponseError$inboundSchema } from "../models/errors/notfoundresponseerror.js"; import { UnauthorizedResponseError$inboundSchema as errors_UnauthorizedResponseError$inboundSchema } from "../models/errors/unauthorizedresponseerror.js";
+import { BadRequestResponseError$inboundSchema as errors_BadRequestResponseError$inboundSchema } from "../models/errors/badrequestresponseerror.js"; import { ConflictResponseError$inboundSchema as errors_ConflictResponseError$inboundSchema } from "../models/errors/conflictresponseerror.js"; import { ForbiddenResponseError$inboundSchema as errors_ForbiddenResponseError$inboundSchema } from "../models/errors/forbiddenresponseerror.js"; import { InternalServerResponseError$inboundSchema as errors_InternalServerResponseError$inboundSchema } from "../models/errors/internalserverresponseerror.js"; import { NotFoundResponseError$inboundSchema as errors_NotFoundResponseError$inboundSchema } from "../models/errors/notfoundresponseerror.js"; import { UnauthorizedResponseError$inboundSchema as errors_UnauthorizedResponseError$inboundSchema } from "../models/errors/unauthorizedresponseerror.js";
 import { UpdateBYOKKeyResponse$inboundSchema as models_UpdateBYOKKeyResponse$inboundSchema } from "../models/updatebyokkeyresponse.js";
 import { UpdateBYOKKeyRequest$outboundSchema as operations_UpdateBYOKKeyRequest$outboundSchema } from "../models/operations/updatebyokkey.js";
 import { APIPromise } from "../types/async.js";
@@ -97,7 +97,7 @@ async function $do(client, request, options) {
     const responseFields = {
         HttpMeta: { Response: response, Request: req },
     };
-    const [result] = await M.match(M.json(200, models_UpdateBYOKKeyResponse$inboundSchema), M.jsonErr(400, errors_BadRequestResponseError$inboundSchema), M.jsonErr(401, errors_UnauthorizedResponseError$inboundSchema), M.jsonErr(403, errors_ForbiddenResponseError$inboundSchema), M.jsonErr(404, errors_NotFoundResponseError$inboundSchema), M.jsonErr(500, errors_InternalServerResponseError$inboundSchema), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
+    const [result] = await M.match(M.json(200, models_UpdateBYOKKeyResponse$inboundSchema), M.jsonErr(400, errors_BadRequestResponseError$inboundSchema), M.jsonErr(401, errors_UnauthorizedResponseError$inboundSchema), M.jsonErr(403, errors_ForbiddenResponseError$inboundSchema), M.jsonErr(404, errors_NotFoundResponseError$inboundSchema), M.jsonErr(409, errors_ConflictResponseError$inboundSchema), M.jsonErr(500, errors_InternalServerResponseError$inboundSchema), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
     if (!result.ok) {
         return [result, { status: "complete", request: req, response }];
     }

package/esm/lib/config.d.ts

@@ -50,8 +50,8 @@ export declare function serverURLFromOptions(options: SDKOptions): URL | null;
 export declare const SDK_METADATA: {
     readonly language: "typescript";
     readonly openapiDocVersion: "1.0.0";
-    readonly sdkVersion: "1.4.21";
+    readonly sdkVersion: "1.4.23";
     readonly genVersion: "2.914.0";
-    readonly userAgent: "speakeasy-sdk/typescript 1.4.21 2.914.0 1.0.0 @openrouter/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 1.4.23 2.914.0 1.0.0 @openrouter/sdk";
 };
 //# sourceMappingURL=config.d.ts.map

package/esm/lib/config.js

@@ -29,8 +29,8 @@ export function serverURLFromOptions(options) {
 export const SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.0.0",
-    sdkVersion: "1.4.21",
+    sdkVersion: "1.4.23",
     genVersion: "2.914.0",
-    userAgent: "speakeasy-sdk/typescript 1.4.21 2.914.0 1.0.0 @openrouter/sdk",
+    userAgent: "speakeasy-sdk/typescript 1.4.23 2.914.0 1.0.0 @openrouter/sdk",
 };
 //# sourceMappingURL=config.js.map

package/esm/models/batchproviderpreferences.d.ts

@@ -2,9 +2,17 @@ import * as z from "zod/v4";
 import { ProviderName } from "./providername.js";
 export type BatchProviderPreferencesOnly = ProviderName | string;
 /**
- * Batch provider routing preferences. Only `provider.only` is supported.
+ * Batch provider routing preferences. Only `provider.only` and `provider.allow_fallbacks` are supported.
  */
 export type BatchProviderPreferences = {
+    /**
+     * Whether to allow backup providers to serve requests
+     *
+     * @remarks
+     * - true: (default) when the primary provider (or your custom providers in "order") is unavailable, use the next best provider.
+     * - false: use only the primary/custom provider, and return the upstream error if it's unavailable.
+     */
+    allowFallbacks?: boolean | null | undefined;
     /**
      * List of provider slugs to allow. If provided, this list is merged with your account-wide allowed provider settings for this request.
      */
@@ -17,6 +25,7 @@ export declare const BatchProviderPreferencesOnly$outboundSchema: z.ZodType<Batc
 export declare function batchProviderPreferencesOnlyToJSON(batchProviderPreferencesOnly: BatchProviderPreferencesOnly): string;
 /** @internal */
 export type BatchProviderPreferences$Outbound = {
+    allow_fallbacks?: boolean | null | undefined;
     only?: Array<string | string> | null | undefined;
 };
 /** @internal */

package/esm/models/batchproviderpreferences.js

@@ -3,6 +3,7 @@
  * @generated-id: 250964898edb
  */
 import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
 import { ProviderName$outboundSchema } from "./providername.js";
 /** @internal */
 export const BatchProviderPreferencesOnly$outboundSchema = z.union([ProviderName$outboundSchema, z.string()]);
@@ -11,8 +12,13 @@ export function batchProviderPreferencesOnlyToJSON(batchProviderPreferencesOnly)
 }
 /** @internal */
 export const BatchProviderPreferences$outboundSchema = z.object({
+    allowFallbacks: z.nullable(z.boolean()).optional(),
     only: z.nullable(z.array(z.union([ProviderName$outboundSchema, z.string()])))
         .optional(),
+}).transform((v) => {
+    return remap$(v, {
+        allowFallbacks: "allow_fallbacks",
+    });
 });
 export function batchProviderPreferencesToJSON(batchProviderPreferences) {
     return JSON.stringify(BatchProviderPreferences$outboundSchema.parse(batchProviderPreferences));

package/esm/models/batchsubmitbody.d.ts

@@ -29,7 +29,7 @@ export type BatchSubmitBody = {
     endpoint: Endpoint;
     model: string;
     /**
-     * Batch provider routing preferences. Only `provider.only` is supported.
+     * Batch provider routing preferences. Only `provider.only` and `provider.allow_fallbacks` are supported.
      */
     provider?: BatchProviderPreferences | null | undefined;
     requests: Array<RequestT>;

package/esm/models/byokkey.d.ts

@@ -1,7 +1,20 @@
 import * as z from "zod/v4";
+import { OpenEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { BYOKProviderSlug } from "./byokproviderslug.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+/**
+ * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`.
+ */
+export declare const BYOKKeyDeclaredRegion: {
+    readonly Global: "global";
+    readonly Europe: "europe";
+    readonly Us: "us";
+};
+/**
+ * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`.
+ */
+export type BYOKKeyDeclaredRegion = OpenEnum<typeof BYOKKeyDeclaredRegion>;
 export type BYOKKey = {
     /**
      * Optional allowlist of OpenRouter API key hashes (`api_keys.hash`) that may use this credential. `null` means no restriction.
@@ -19,6 +32,10 @@ export type BYOKKey = {
      * ISO timestamp of when the credential was created.
      */
     createdAt: string;
+    /**
+     * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`.
+     */
+    declaredRegion: BYOKKeyDeclaredRegion | null;
     /**
      * Your declaration of whether the upstream provider account behind this credential has zero data retention (ZDR). `null` inherits OpenRouter's data policy for the provider's endpoint; `true` declares the account ZDR so requests that require ZDR may route to this credential even when the shared endpoint retains data; `false` declares it non-ZDR so such requests never route to it. Self-declared and not verified by OpenRouter.
      */
@@ -65,6 +82,8 @@ export type BYOKKey = {
     workspaceId: string | null;
 };
 /** @internal */
+export declare const BYOKKeyDeclaredRegion$inboundSchema: z.ZodType<BYOKKeyDeclaredRegion, unknown>;
+/** @internal */
 export declare const BYOKKey$inboundSchema: z.ZodType<BYOKKey, unknown>;
 export declare function byokKeyFromJSON(jsonString: string): SafeParseResult<BYOKKey, SDKValidationError>;
 //# sourceMappingURL=byokkey.d.ts.map

package/esm/models/byokkey.js

@@ -5,13 +5,25 @@
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
+import * as openEnums from "../types/enums.js";
 import { BYOKProviderSlug$inboundSchema, } from "./byokproviderslug.js";
+/**
+ * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`.
+ */
+export const BYOKKeyDeclaredRegion = {
+    Global: "global",
+    Europe: "europe",
+    Us: "us",
+};
+/** @internal */
+export const BYOKKeyDeclaredRegion$inboundSchema = openEnums.inboundSchema(BYOKKeyDeclaredRegion);
 /** @internal */
 export const BYOKKey$inboundSchema = z.object({
     allowed_api_key_hashes: z.nullable(z.array(z.string())),
     allowed_models: z.nullable(z.array(z.string())),
     allowed_user_ids: z.nullable(z.array(z.string())),
     created_at: z.string(),
+    declared_region: z.nullable(BYOKKeyDeclaredRegion$inboundSchema),
     declared_zdr: z.nullable(z.boolean()),
     disabled: z.boolean(),
     id: z.string(),
@@ -29,6 +41,7 @@ export const BYOKKey$inboundSchema = z.object({
         "allowed_models": "allowedModels",
         "allowed_user_ids": "allowedUserIds",
         "created_at": "createdAt",
+        "declared_region": "declaredRegion",
         "declared_zdr": "declaredZdr",
         "is_byok_only": "isByokOnly",
         "is_fallback": "isFallback",

package/esm/models/createbyokkeyrequest.d.ts

@@ -1,5 +1,18 @@
 import * as z from "zod/v4";
+import { OpenEnum } from "../types/enums.js";
 import { BYOKProviderSlug } from "./byokproviderslug.js";
+/**
+ * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`. Defaults to the key's region for OpenAI and Fireworks, otherwise `null`.
+ */
+export declare const CreateBYOKKeyRequestDeclaredRegion: {
+    readonly Global: "global";
+    readonly Europe: "europe";
+    readonly Us: "us";
+};
+/**
+ * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`. Defaults to the key's region for OpenAI and Fireworks, otherwise `null`.
+ */
+export type CreateBYOKKeyRequestDeclaredRegion = OpenEnum<typeof CreateBYOKKeyRequestDeclaredRegion>;
 export type CreateBYOKKeyRequest = {
     /**
      * Optional allowlist of OpenRouter API key hashes (`api_keys.hash`) that may use this credential. `null` means no restriction. Must contain at least one hash if provided. Hashes that do not belong to your account return a 400.
@@ -13,6 +26,10 @@ export type CreateBYOKKeyRequest = {
      * Optional allowlist of user IDs that may use this credential. `null` means no restriction.
      */
     allowedUserIds?: Array<string> | null | undefined;
+    /**
+     * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`. Defaults to the key's region for OpenAI and Fireworks, otherwise `null`.
+     */
+    declaredRegion?: CreateBYOKKeyRequestDeclaredRegion | null | undefined;
     /**
      * Your declaration of whether the upstream provider account behind this credential has zero data retention (ZDR). `null` inherits OpenRouter's data policy for the provider's endpoint; `true` declares the account ZDR so requests that require ZDR may route to this credential even when the shared endpoint retains data; `false` declares it non-ZDR so such requests never route to it. Self-declared and not verified by OpenRouter. Defaults to `null`.
      */
@@ -51,10 +68,13 @@ export type CreateBYOKKeyRequest = {
     workspaceId?: string | undefined;
 };
 /** @internal */
+export declare const CreateBYOKKeyRequestDeclaredRegion$outboundSchema: z.ZodType<string, CreateBYOKKeyRequestDeclaredRegion>;
+/** @internal */
 export type CreateBYOKKeyRequest$Outbound = {
     allowed_api_key_hashes?: Array<string> | null | undefined;
     allowed_models?: Array<string> | null | undefined;
     allowed_user_ids?: Array<string> | null | undefined;
+    declared_region?: string | null | undefined;
     declared_zdr?: boolean | null | undefined;
     disabled?: boolean | undefined;
     is_byok_only?: boolean | undefined;

package/esm/models/createbyokkeyrequest.js

@@ -4,12 +4,25 @@
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";
+import * as openEnums from "../types/enums.js";
 import { BYOKProviderSlug$outboundSchema, } from "./byokproviderslug.js";
+/**
+ * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`. Defaults to the key's region for OpenAI and Fireworks, otherwise `null`.
+ */
+export const CreateBYOKKeyRequestDeclaredRegion = {
+    Global: "global",
+    Europe: "europe",
+    Us: "us",
+};
+/** @internal */
+export const CreateBYOKKeyRequestDeclaredRegion$outboundSchema = openEnums.outboundSchema(CreateBYOKKeyRequestDeclaredRegion);
 /** @internal */
 export const CreateBYOKKeyRequest$outboundSchema = z.object({
     allowedApiKeyHashes: z.nullable(z.array(z.string())).optional(),
     allowedModels: z.nullable(z.array(z.string())).optional(),
     allowedUserIds: z.nullable(z.array(z.string())).optional(),
+    declaredRegion: z.nullable(CreateBYOKKeyRequestDeclaredRegion$outboundSchema)
+        .optional(),
     declaredZdr: z.nullable(z.boolean()).optional(),
     disabled: z.boolean().optional(),
     isByokOnly: z.boolean().optional(),
@@ -24,6 +37,7 @@ export const CreateBYOKKeyRequest$outboundSchema = z.object({
         allowedApiKeyHashes: "allowed_api_key_hashes",
         allowedModels: "allowed_models",
         allowedUserIds: "allowed_user_ids",
+        declaredRegion: "declared_region",
         declaredZdr: "declared_zdr",
         isByokOnly: "is_byok_only",
         isFallback: "is_fallback",

package/esm/models/updatebyokkeyrequest.d.ts

@@ -1,4 +1,17 @@
 import * as z from "zod/v4";
+import { OpenEnum } from "../types/enums.js";
+/**
+ * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`. Omit to leave the stored value unchanged (rotating an OpenAI or Fireworks `key` re-derives it from the new key); `null` clears the declaration.
+ */
+export declare const UpdateBYOKKeyRequestDeclaredRegion: {
+    readonly Global: "global";
+    readonly Europe: "europe";
+    readonly Us: "us";
+};
+/**
+ * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`. Omit to leave the stored value unchanged (rotating an OpenAI or Fireworks `key` re-derives it from the new key); `null` clears the declaration.
+ */
+export type UpdateBYOKKeyRequestDeclaredRegion = OpenEnum<typeof UpdateBYOKKeyRequestDeclaredRegion>;
 export type UpdateBYOKKeyRequest = {
     /**
      * Optional allowlist of OpenRouter API key hashes (`api_keys.hash`) that may use this credential. `null` clears the restriction. Must contain at least one hash if provided. Hashes that do not belong to your account return a 400.
@@ -12,6 +25,10 @@ export type UpdateBYOKKeyRequest = {
      * Optional allowlist of user IDs that may use this credential. `null` means no restriction.
      */
     allowedUserIds?: Array<string> | null | undefined;
+    /**
+     * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`. Omit to leave the stored value unchanged (rotating an OpenAI or Fireworks `key` re-derives it from the new key); `null` clears the declaration.
+     */
+    declaredRegion?: UpdateBYOKKeyRequestDeclaredRegion | null | undefined;
     /**
      * Your declaration of whether the upstream provider account behind this credential has zero data retention (ZDR). `null` inherits OpenRouter's data policy for the provider's endpoint; `true` declares the account ZDR so requests that require ZDR may route to this credential even when the shared endpoint retains data; `false` declares it non-ZDR so such requests never route to it. Self-declared and not verified by OpenRouter. Omit to leave the stored value unchanged; `null` clears the declaration.
      */
@@ -42,10 +59,13 @@ export type UpdateBYOKKeyRequest = {
     name?: string | null | undefined;
 };
 /** @internal */
+export declare const UpdateBYOKKeyRequestDeclaredRegion$outboundSchema: z.ZodType<string, UpdateBYOKKeyRequestDeclaredRegion>;
+/** @internal */
 export type UpdateBYOKKeyRequest$Outbound = {
     allowed_api_key_hashes?: Array<string> | null | undefined;
     allowed_models?: Array<string> | null | undefined;
     allowed_user_ids?: Array<string> | null | undefined;
+    declared_region?: string | null | undefined;
     declared_zdr?: boolean | null | undefined;
     disabled?: boolean | undefined;
     is_byok_only?: boolean | undefined;

package/esm/models/updatebyokkeyrequest.js

@@ -4,11 +4,24 @@
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";
+import * as openEnums from "../types/enums.js";
+/**
+ * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`. Omit to leave the stored value unchanged (rotating an OpenAI or Fireworks `key` re-derives it from the new key); `null` clears the declaration.
+ */
+export const UpdateBYOKKeyRequestDeclaredRegion = {
+    Global: "global",
+    Europe: "europe",
+    Us: "us",
+};
+/** @internal */
+export const UpdateBYOKKeyRequestDeclaredRegion$outboundSchema = openEnums.outboundSchema(UpdateBYOKKeyRequestDeclaredRegion);
 /** @internal */
 export const UpdateBYOKKeyRequest$outboundSchema = z.object({
     allowedApiKeyHashes: z.nullable(z.array(z.string())).optional(),
     allowedModels: z.nullable(z.array(z.string())).optional(),
     allowedUserIds: z.nullable(z.array(z.string())).optional(),
+    declaredRegion: z.nullable(UpdateBYOKKeyRequestDeclaredRegion$outboundSchema)
+        .optional(),
     declaredZdr: z.nullable(z.boolean()).optional(),
     disabled: z.boolean().optional(),
     isByokOnly: z.boolean().optional(),
@@ -21,6 +34,7 @@ export const UpdateBYOKKeyRequest$outboundSchema = z.object({
         allowedApiKeyHashes: "allowed_api_key_hashes",
         allowedModels: "allowed_models",
         allowedUserIds: "allowed_user_ids",
+        declaredRegion: "declared_region",
         declaredZdr: "declared_zdr",
         isByokOnly: "is_byok_only",
         isFallback: "is_fallback",

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@openrouter/sdk",
-  "version": "1.4.21",
+  "version": "1.4.23",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "1.4.21",
+  "version": "1.4.23",
   "author": "OpenRouter",
   "description": "The OpenRouter TypeScript SDK is a type-safe toolkit for building AI applications with access to 400+ language models through a unified API.",
   "keywords": [
@@ -73,15 +73,15 @@
     "lint": "eslint --cache --max-warnings=0 src",
     "build": "tsc && node scripts/unbarrel-imports.js",
     "prepublishOnly": "npm run build",
-    "prepare": "npm run build",
+    "test:e2e": "vitest --run --project e2e",
+    "typecheck:transit": "exit 0",
+    "postinstall": "node scripts/check-types.js || true",
     "test": "vitest --run --project unit",
     "test:transit": "exit 0",
+    "test:watch": "vitest --watch --project unit",
     "typecheck": "tsc --noEmit",
-    "typecheck:transit": "exit 0",
     "compile": "tsc && node scripts/unbarrel-imports.js",
-    "test:e2e": "vitest --run --project e2e",
-    "test:watch": "vitest --watch --project unit",
-    "postinstall": "node scripts/check-types.js || true"
+    "prepare": "npm run build"
   },
   "peerDependencies": {