@unkey/api 2.1.3 → 2.2.0

package/src/mcp-server/shared.ts

@@ -1,74 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import * as z from "zod/v3";
-import { bytesToBase64 } from "../lib/base64.js";
-type BinaryData =
-  | Uint8Array
-  | ArrayBuffer
-  | Blob
-  | ReadableStream
-  | Response
-  | string;
-
-export async function consumeStream(
-  stream: ReadableStream<Uint8Array>,
-): Promise<Uint8Array> {
-  const reader = stream.getReader();
-  const chunks: Uint8Array[] = [];
-
-  try {
-    while (true) {
-      const { done, value } = await reader.read();
-      if (value != null) chunks.push(value);
-      if (done) break;
-    }
-  } finally {
-    reader.releaseLock();
-  }
-
-  return new Uint8Array(await new Blob(chunks).arrayBuffer());
-}
-
-export function isAsyncIterable(
-  value: unknown,
-): value is AsyncIterable<string> {
-  return (
-    typeof value === "object" && value != null && Symbol.asyncIterator in value
-  );
-}
-
-export function isBinaryData(value: unknown): value is BinaryData {
-  return (
-    value instanceof Uint8Array
-    || value instanceof ArrayBuffer
-    || value instanceof Blob
-    || value instanceof ReadableStream
-    || value instanceof Response
-    || typeof value === "string"
-  );
-}
-
-const base64Schema = z.string().base64();
-
-export async function valueToBase64(
-  value: BinaryData | null | undefined,
-): Promise<string | null> {
-  if (value == null) {
-    return null;
-  } else if (value instanceof Uint8Array) {
-    return bytesToBase64(value);
-  } else if (value instanceof ArrayBuffer) {
-    return bytesToBase64(new Uint8Array(value));
-  } else if (value instanceof Response || value instanceof Blob) {
-    return bytesToBase64(new Uint8Array(await value.arrayBuffer()));
-  } else if (value instanceof ReadableStream) {
-    return bytesToBase64(await consumeStream(value));
-  } else if (typeof value === "string") {
-    return base64Schema.parse(value);
-  } else {
-    value satisfies never;
-    throw new Error(`Unsupported image value type: ${typeof value}`);
-  }
-}

package/src/mcp-server/tools/analyticsGetVerifications.ts

@@ -1,39 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { analyticsGetVerifications } from "../../funcs/analyticsGetVerifications.js";
-import * as components from "../../models/components/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: components.V2AnalyticsGetVerificationsRequestBody$inboundSchema,
-};
-
-export const tool$analyticsGetVerifications: ToolDefinition<typeof args> = {
-  name: "analytics-get-verifications",
-  description: `Query key verification data
-
-Execute custom SQL queries against your key verification analytics.
-For complete documentation including available tables, columns, data types, query examples, see the schema reference in the API documentation.
-`,
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await analyticsGetVerifications(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value;
-
-    return formatResult(value, apiCall);
-  },
-};

package/src/mcp-server/tools/apisCreateApi.ts

@@ -1,47 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { apisCreateApi } from "../../funcs/apisCreateApi.js";
-import * as components from "../../models/components/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: components.V2ApisCreateApiRequestBody$inboundSchema,
-};
-
-export const tool$apisCreateApi: ToolDefinition<typeof args> = {
-  name: "apis-create-api",
-  description: `Create API namespace
-
-Create an API namespace for organizing keys by environment, service, or product.
-
-Use this to separate production from development keys, isolate different services, or manage multiple products. Each API gets a unique identifier and dedicated infrastructure for secure key operations.
-
-**Important**: API names must be unique within your workspace and cannot be changed after creation.
-
-**Required Permissions**
-
-Your root key must have one of the following permissions:
-- \`api.*.create_api\` (to create APIs in any workspace)
-`,
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await apisCreateApi(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value;
-
-    return formatResult(value, apiCall);
-  },
-};

package/src/mcp-server/tools/apisDeleteApi.ts

@@ -1,50 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { apisDeleteApi } from "../../funcs/apisDeleteApi.js";
-import * as components from "../../models/components/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: components.V2ApisDeleteApiRequestBody$inboundSchema,
-};
-
-export const tool$apisDeleteApi: ToolDefinition<typeof args> = {
-  name: "apis-delete-api",
-  description: `Delete API namespace
-
-Permanently delete an API namespace and immediately invalidate all associated keys.
-
-Use this for cleaning up development environments, retiring deprecated services, or removing unused resources.
-All keys in the namespace are immediately marked as deleted and will fail verification with \`code=NOT_FOUND\`.
-
-**Important**: This operation is immediate and permanent. Verify you have the correct API ID before deletion.
-If delete protection is enabled, disable it first through the dashboard or API configuration.
-
-**Required Permissions**
-
-Your root key must have one of the following permissions:
-- \`api.*.delete_api\` (to delete any API)
-- \`api.<api_id>.delete_api\` (to delete a specific API)
-`,
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await apisDeleteApi(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value;
-
-    return formatResult(value, apiCall);
-  },
-};

package/src/mcp-server/tools/apisGetApi.ts

@@ -1,46 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { apisGetApi } from "../../funcs/apisGetApi.js";
-import * as components from "../../models/components/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: components.V2ApisGetApiRequestBody$inboundSchema,
-};
-
-export const tool$apisGetApi: ToolDefinition<typeof args> = {
-  name: "apis-get-api",
-  description: `Get API namespace
-
-Retrieve basic information about an API namespace including its ID and name.
-
-Use this to verify an API exists before performing operations, get the human-readable name when you only have the API ID, or confirm access to a specific namespace. For detailed key information, use the \`listKeys\` endpoint instead.
-
-**Required Permissions**
-
-Your root key must have one of the following permissions:
-- \`api.*.read_api\` (to read any API)
-- \`api.<api_id>.read_api\` (to read a specific API)
-`,
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await apisGetApi(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value;
-
-    return formatResult(value, apiCall);
-  },
-};

package/src/mcp-server/tools/apisListKeys.ts

@@ -1,54 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { apisListKeys } from "../../funcs/apisListKeys.js";
-import * as components from "../../models/components/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: components.V2ApisListKeysRequestBody$inboundSchema,
-};
-
-export const tool$apisListKeys: ToolDefinition<typeof args> = {
-  name: "apis-list-keys",
-  description: `List API keys
-
-Retrieve a paginated list of API keys for dashboard and administrative interfaces.
-
-Use this to build key management dashboards, filter keys by user with \`externalId\`, or retrieve key details for administrative purposes. Each key includes status, metadata, permissions, and usage limits.
-
-**Important**: Set \`decrypt: true\` only in secure contexts to retrieve plaintext key values from recoverable keys.
-
-**Required Permissions**
-
-Your root key must have one of the following permissions for basic key listing:
-- \`api.*.read_key\` (to read keys from any API)
-- \`api.<api_id>.read_key\` (to read keys from a specific API)
-
-Additionally, you need read access to the API itself:
-- \`api.*.read_api\` or \`api.<api_id>.read_api\`
-
-Additional permission required for decrypt functionality:
-- \`api.*.decrypt_key\` or \`api.<api_id>.decrypt_key\`
-`,
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await apisListKeys(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value;
-
-    return formatResult(value, apiCall);
-  },
-};

package/src/mcp-server/tools/identitiesCreateIdentity.ts

@@ -1,43 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { identitiesCreateIdentity } from "../../funcs/identitiesCreateIdentity.js";
-import * as components from "../../models/components/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: components.V2IdentitiesCreateIdentityRequestBody$inboundSchema,
-};
-
-export const tool$identitiesCreateIdentity: ToolDefinition<typeof args> = {
-  name: "identities-create-identity",
-  description: `Create Identity
-
-Create an identity to group multiple API keys under a single entity. Identities enable shared rate limits and metadata across all associated keys.
-
-Perfect for users with multiple devices, organizations with multiple API keys, or when you need unified rate limiting across different services.
-
-**Important**
-Requires \`identity.*.create_identity\` permission
-`,
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await identitiesCreateIdentity(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value;
-
-    return formatResult(value, apiCall);
-  },
-};

package/src/mcp-server/tools/identitiesDeleteIdentity.ts

@@ -1,45 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { identitiesDeleteIdentity } from "../../funcs/identitiesDeleteIdentity.js";
-import * as components from "../../models/components/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: components.V2IdentitiesDeleteIdentityRequestBody$inboundSchema,
-};
-
-export const tool$identitiesDeleteIdentity: ToolDefinition<typeof args> = {
-  name: "identities-delete-identity",
-  description: `Delete Identity
-
-Permanently delete an identity. This operation cannot be undone.
-
-Use this for data cleanup, compliance requirements, or when removing entities from your system.
-
-> **Important**  
-> Requires \`identity.*.delete_identity\` permission  
-> Associated API keys remain functional but lose shared resources  
-> External ID becomes available for reuse immediately
-`,
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await identitiesDeleteIdentity(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value;
-
-    return formatResult(value, apiCall);
-  },
-};

package/src/mcp-server/tools/identitiesGetIdentity.ts

@@ -1,43 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { identitiesGetIdentity } from "../../funcs/identitiesGetIdentity.js";
-import * as components from "../../models/components/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: components.V2IdentitiesGetIdentityRequestBody$inboundSchema,
-};
-
-export const tool$identitiesGetIdentity: ToolDefinition<typeof args> = {
-  name: "identities-get-identity",
-  description: `Get Identity
-
-Retrieve an identity by external ID. Returns metadata, rate limits, and other associated data.
-
-Use this to check if an identity exists, view configurations, or build management dashboards.
-
-> **Important**  
-> Requires \`identity.*.read_identity\` permission
-`,
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await identitiesGetIdentity(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value;
-
-    return formatResult(value, apiCall);
-  },
-};

package/src/mcp-server/tools/identitiesListIdentities.ts

@@ -1,43 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { identitiesListIdentities } from "../../funcs/identitiesListIdentities.js";
-import * as components from "../../models/components/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: components.V2IdentitiesListIdentitiesRequestBody$inboundSchema,
-};
-
-export const tool$identitiesListIdentities: ToolDefinition<typeof args> = {
-  name: "identities-list-identities",
-  description: `List Identities
-
-Get a paginated list of all identities in your workspace. Returns metadata and rate limit configurations.
-
-Perfect for building management dashboards, auditing configurations, or browsing your identities.
-
-> **Important**  
-> Requires \`identity.*.read_identity\` permission
-`,
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await identitiesListIdentities(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value.result;
-
-    return formatResult(value, apiCall);
-  },
-};

package/src/mcp-server/tools/identitiesUpdateIdentity.ts

@@ -1,44 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { identitiesUpdateIdentity } from "../../funcs/identitiesUpdateIdentity.js";
-import * as components from "../../models/components/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: components.V2IdentitiesUpdateIdentityRequestBody$inboundSchema,
-};
-
-export const tool$identitiesUpdateIdentity: ToolDefinition<typeof args> = {
-  name: "identities-update-identity",
-  description: `Update Identity
-
-Update an identity's metadata and rate limits. Only specified fields are modified - others remain unchanged.
-
-Perfect for subscription changes, plan upgrades, or updating user information. Changes take effect immediately.
-
-> **Important**
-> Requires \`identity.*.update_identity\` permission
-> Rate limit changes propagate within 30 seconds
-`,
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await identitiesUpdateIdentity(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value;
-
-    return formatResult(value, apiCall);
-  },
-};

package/src/mcp-server/tools/keysAddPermissions.ts

@@ -1,52 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { keysAddPermissions } from "../../funcs/keysAddPermissions.js";
-import * as components from "../../models/components/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: components.V2KeysAddPermissionsRequestBody$inboundSchema,
-};
-
-export const tool$keysAddPermissions: ToolDefinition<typeof args> = {
-  name: "keys-add-permissions",
-  description: `Add key permissions
-
-Add permissions to a key without affecting existing permissions.
-
-Use this for privilege upgrades, enabling new features, or plan changes that grant additional capabilities. Permissions granted through roles remain unchanged.
-
-**Important**: Changes take effect immediately with up to 30-second edge propagation.
-
-**Required Permissions**
-
-Your root key must have one of the following permissions:
-- \`api.*.update_key\` (to update keys in any API)
-- \`api.<api_id>.update_key\` (to update keys in a specific API)
-
-**Side Effects**
-
-Invalidates the key cache for immediate effect, and makes permissions available for verification within 30 seconds across all regions.
-`,
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await keysAddPermissions(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value;
-
-    return formatResult(value, apiCall);
-  },
-};

package/src/mcp-server/tools/keysAddRoles.ts

@@ -1,52 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import { keysAddRoles } from "../../funcs/keysAddRoles.js";
-import * as components from "../../models/components/index.js";
-import { formatResult, ToolDefinition } from "../tools.js";
-
-const args = {
-  request: components.V2KeysAddRolesRequestBody$inboundSchema,
-};
-
-export const tool$keysAddRoles: ToolDefinition<typeof args> = {
-  name: "keys-add-roles",
-  description: `Add key roles
-
-Add roles to a key without affecting existing roles or permissions.
-
-Use this for privilege upgrades, enabling new feature sets, or subscription changes that grant additional role-based capabilities. Direct permissions remain unchanged.
-
-**Important**: Changes take effect immediately with up to 30-second edge propagation.
-
-**Required Permissions**
-
-Your root key must have one of the following permissions:
-- \`api.*.update_key\` (to update keys in any API)
-- \`api.<api_id>.update_key\` (to update keys in a specific API)
-
-**Side Effects**
-
-Invalidates the key cache for immediate effect, and makes role assignments available for verification within 30 seconds across all regions.
-`,
-  args,
-  tool: async (client, args, ctx) => {
-    const [result, apiCall] = await keysAddRoles(
-      client,
-      args.request,
-      { fetchOptions: { signal: ctx.signal } },
-    ).$inspect();
-
-    if (!result.ok) {
-      return {
-        content: [{ type: "text", text: result.error.message }],
-        isError: true,
-      };
-    }
-
-    const value = result.value;
-
-    return formatResult(value, apiCall);
-  },
-};