> ## Documentation Index
> Fetch the complete documentation index at: https://openrouter.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateKeysRequestBody

## Example Usage

```typescript theme={null}
import { CreateKeysRequestBody } from "@openrouter/sdk/models/operations";

let value: CreateKeysRequestBody = {
  name: "My New API Key",
};
```

## Fields

| Field                | Type                                                                                          | Required             | Description                                                                                                                                                                                                                 | Example                              |
| -------------------- | --------------------------------------------------------------------------------------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
| `creatorUserId`      | *string*                                                                                      | :heavy\_minus\_sign: | Optional user ID of the key creator. Only meaningful for organization-owned keys where a specific member is creating the key.                                                                                               | user\_2dHFtVWx2n56w6HkM0000000000    |
| `expiresAt`          | [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date) | :heavy\_minus\_sign: | Optional ISO 8601 UTC timestamp when the API key should expire. Must be UTC, other timezones will be rejected                                                                                                               | 2027-12-31T23:59:59Z                 |
| `externalApiKey`     | *string*                                                                                      | :heavy\_minus\_sign: | Optional partner-supplied API key. Stored as a SHA-256 hash and never returned. Accepted only when authenticating with a Connect client secret; supplying it with a management key is rejected with 403.                    |                                      |
| `externalUser`       | *string*                                                                                      | :heavy\_minus\_sign: | Partner's end-user identifier for attribution, between 1 and 512 characters. Accepted only when authenticating with a Connect client secret, where it is required; supplying it with a management key is rejected with 403. |                                      |
| `includeByokInLimit` | *boolean*                                                                                     | :heavy\_minus\_sign: | Whether to include BYOK usage in the limit                                                                                                                                                                                  | true                                 |
| `limit`              | *number*                                                                                      | :heavy\_minus\_sign: | Optional spending limit for the API key in USD                                                                                                                                                                              | 50                                   |
| `limitReset`         | [operations.CreateKeysLimitReset](../../models/operations/createkeyslimitreset.mdx)           | :heavy\_minus\_sign: | Type of limit reset for the API key (daily, weekly, monthly, or null for no reset). Resets happen automatically at midnight UTC, and weeks are Monday through Sunday.                                                       | monthly                              |
| `name`               | *string*                                                                                      | :heavy\_check\_mark: | Name for the new API key                                                                                                                                                                                                    | My New API Key                       |
| `workspaceId`        | *string*                                                                                      | :heavy\_minus\_sign: | The workspace to create the API key in. Defaults to the default workspace if not provided.                                                                                                                                  | 0df9e665-d932-5740-b2c7-b52af166bc11 |