---
title: "Changes to Create Api Key"
method: POST
path: "/keys"
---

# Changes to Create Api Key

`POST /keys`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 57 revisions.

- **2026-10-13** `17de96e3dd55`: 3 info
- **2026-10-06** `8d326a331de9`: 2 info
- **2026-09-24** `b37fb58fd012`: 1 breaking, 25 info
- **2026-09-24** `22fe65099001`: 1 info
- **2026-09-10** `ded660373609`: 1 warning, 1 info

## Changes

- **2026-10-13** `17de96e3dd55`: 3 info
  - added the required property `key_prefix` to the response with the `200` status
  - added the required property `key_retrievable` to the response with the `200` status
  - added the required property `masked_key` to the response with the `200` status
- **2026-10-06** `8d326a331de9`: 2 info
  - added the new optional request property `customer_ref`
  - added the required property `customer_ref` to the response with the `200` status
- **2026-09-24** `b37fb58fd012`: 1 breaking, 25 info
  - the response's body type changed from no type to `object` for status `200`
  - added the new optional request property `daily_budget_usd`
  - added the new optional request property `max_budget_usd`
  - added the new optional request property `monthly_budget_usd`
  - added the new `billing` enum value to the request property `scopes/anyOf[subschema #1]/items/`
  - added the required property `created_at` to the response with the `200` status
  - added the required property `created_by_user_id` to the response with the `200` status
  - added the required property `daily_budget_usd` to the response with the `200` status
  - added the required property `expires_at` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `is_active` to the response with the `200` status
  - added the required property `key` to the response with the `200` status
  - added the required property `last_refusal` to the response with the `200` status
  - added the required property `last_used` to the response with the `200` status
  - added the required property `max_budget_usd` to the response with the `200` status
  - added the required property `monthly_budget_usd` to the response with the `200` status
  - added the required property `name` to the response with the `200` status
  - added the required property `pod_visibility` to the response with the `200` status
  - added the required property `pods_count` to the response with the `200` status
  - added the required property `refused_today` to the response with the `200` status
  - added the required property `scopes` to the response with the `200` status
  - added the required property `spent_month_usd` to the response with the `200` status
  - added the required property `spent_today_usd` to the response with the `200` status
  - added the required property `spent_total_usd` to the response with the `200` status
  - added the required property `user_id` to the response with the `200` status
  - added the required property `workspace_id` to the response with the `200` status
- **2026-09-24** `22fe65099001`: 1 info
  - added the new optional request property `pod_visibility`
- **2026-09-10** `ded660373609`: 1 warning, 1 info
  - the `name` request property's maxLength was set to `100`
  - added the new optional request property `scopes`

---

[Operation](https://skmtc.dev/lium/apis/lium-backend-api/docs/keys/post.md) · [API](https://skmtc.dev/lium/apis/lium-backend-api.md) · [Page](https://skmtc.dev/lium/apis/lium-backend-api/changes/keys/post)