---
title: "CreateKeysRequestBody"
---

## Fields

| Field                                                                                                                                                                 | Type                                                                                                                                                                  | Required                                                                                                                                                              | Description                                                                                                                                                           | Example                                                                                                                                                               |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `creator_user_id`                                                                                                                                                     | *OptionalNullable[str]*                                                                                                                                               | :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                                                                                                                                      |
| `expires_at`                                                                                                                                                          | [date](https://docs.python.org/3/library/datetime.html#date-objects)                                                                                                  | :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                                                                                                                                                  |
| `include_byok_in_limit`                                                                                                                                               | *Optional[bool]*                                                                                                                                                      | :heavy_minus_sign:                                                                                                                                                    | Whether to include BYOK usage in the limit                                                                                                                            | true                                                                                                                                                                  |
| `limit`                                                                                                                                                               | *OptionalNullable[float]*                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                    | Optional spending limit for the API key in USD                                                                                                                        | 50                                                                                                                                                                    |
| `limit_reset`                                                                                                                                                         | [OptionalNullable[operations.CreateKeysLimitReset]](../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`                                                                                                                                                                | *str*                                                                                                                                                                 | :heavy_check_mark:                                                                                                                                                    | Name for the new API key                                                                                                                                              | My New API Key                                                                                                                                                        |
| `workspace_id`                                                                                                                                                        | *Optional[str]*                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                    | The workspace to create the API key in. Defaults to the default workspace if not provided.                                                                            | 0df9e665-d932-5740-b2c7-b52af166bc11                                                                                                                                  |