---
title: "Changes to Create API key"
method: POST
path: "/api-keys"
---

# Changes to Create API key

`POST /api-keys`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 28 revisions.

- **2026-08-27** `359d267dca88` — 1 info
- **2026-08-23** `b1ad79e918ac` — 3 info
- **2026-08-15** `09487fd56e29` — 3 info
- **2026-08-14** `7271de071ca5` — 2 info
- **2026-08-11** `089aed4017a8` — 2 breaking, 3 info
- **2026-08-09** `0123533d8361` — 5 info
- **2026-07-26** `270e233e401c` — 1 breaking, 1 warning

## Changes

- **2026-08-27** `359d267dca88` — 1 info
  - deleted the `header` request parameter `X-Agent-ID` with deprecation
- **2026-08-23** `b1ad79e918ac` — 3 info
  - `header` request parameter `X-Agent-ID` was deprecated
  - the `scopes` request property default value changed from `party.read, party.update, invite.read, invite.create, invite.update, invite.delete, membership.create, membership.read, membership.update, membership.delete, payments.create, payments.read, external_parties.create, external_parties.read, direct.create, direct.read, external_accounts.create, wallets.read, wallets.create, wallets.update, wallets.delete, wallets.fund, wallets.deposit, wallets.transfer, wallets.withdraw, delegations.read, delegations.create, delegations.update, delegations.delete, api_keys.read, api_keys.create, api_keys.delete, agents.read, agents.create, agents.update, agents.delete, disputes.read, disputes.create` to `party.read, party.update, invite.read, invite.create, invite.update, invite.delete, membership.create, membership.read, membership.update, membership.delete, payments.create, payments.read, external_parties.create, external_parties.read, direct.create, direct.read, external_accounts.create, wallets.read, wallets.balance, wallets.create, wallets.update, wallets.delete, wallets.fund, wallets.deposit, wallets.transfer, wallets.withdraw, delegations.read, delegations.create, delegations.update, delegations.delete, api_keys.read, api_keys.create, api_keys.delete, agents.read, agents.create, agents.update, agents.delete, disputes.read, disputes.create`
  - added the new `wallets.balance` enum value to the request property `data/attributes/scopes/items/`
- **2026-08-15** `09487fd56e29` — 3 info
  - the `scopes` request property default value changed from `party.read, party.update, invite.read, invite.create, invite.update, invite.delete, membership.create, membership.read, membership.update, membership.delete, payments.create, payments.read, external_parties.create, external_parties.read, direct.create, direct.read, external_accounts.create, wallets.read, wallets.create, wallets.update, wallets.delete, wallets.fund, wallets.withdraw, delegations.read, delegations.create, delegations.update, delegations.delete, api_keys.read, api_keys.create, api_keys.delete, agents.read, agents.create, agents.update, agents.delete, disputes.read, disputes.create` to `party.read, party.update, invite.read, invite.create, invite.update, invite.delete, membership.create, membership.read, membership.update, membership.delete, payments.create, payments.read, external_parties.create, external_parties.read, direct.create, direct.read, external_accounts.create, wallets.read, wallets.create, wallets.update, wallets.delete, wallets.fund, wallets.deposit, wallets.transfer, wallets.withdraw, delegations.read, delegations.create, delegations.update, delegations.delete, api_keys.read, api_keys.create, api_keys.delete, agents.read, agents.create, agents.update, agents.delete, disputes.read, disputes.create`
  - added the new `wallets.deposit` enum value to the request property `data/attributes/scopes/items/`
  - added the new `wallets.transfer` enum value to the request property `data/attributes/scopes/items/`
- **2026-08-14** `7271de071ca5` — 2 info
  - added the new optional request property `data/attributes/tags`
  - added the required property `data/attributes/tags` to the response with the `201` status
- **2026-08-11** `089aed4017a8` — 2 breaking, 3 info
  - removed the enum value `direct_payments.create` of the request property `data/attributes/scopes/items/`
  - removed the enum value `direct_payments.read` of the request property `data/attributes/scopes/items/`
  - the `scopes` request property default value changed from `party.read, party.update, invite.read, invite.create, invite.update, invite.delete, membership.create, membership.read, membership.update, membership.delete, payments.create, payments.read, external_parties.create, external_parties.read, direct_payments.create, direct_payments.read, external_accounts.create, wallets.read, wallets.create, wallets.update, wallets.delete, wallets.fund, wallets.withdraw, delegations.read, delegations.create, delegations.update, delegations.delete, api_keys.read, api_keys.create, api_keys.delete, agents.read, agents.create, agents.update, agents.delete, disputes.read, disputes.create` to `party.read, party.update, invite.read, invite.create, invite.update, invite.delete, membership.create, membership.read, membership.update, membership.delete, payments.create, payments.read, external_parties.create, external_parties.read, direct.create, direct.read, external_accounts.create, wallets.read, wallets.create, wallets.update, wallets.delete, wallets.fund, wallets.withdraw, delegations.read, delegations.create, delegations.update, delegations.delete, api_keys.read, api_keys.create, api_keys.delete, agents.read, agents.create, agents.update, agents.delete, disputes.read, disputes.create`
  - added the new `direct.create` enum value to the request property `data/attributes/scopes/items/`
  - added the new `direct.read` enum value to the request property `data/attributes/scopes/items/`
- **2026-08-09** `0123533d8361` — 5 info
  - the `scopes` request property default value changed from `party.read, party.update, invite.read, invite.create, invite.update, invite.delete, membership.create, membership.read, membership.update, membership.delete, payments.create, payments.read, external_accounts.create, wallets.read, wallets.create, wallets.update, wallets.delete, wallets.fund, wallets.withdraw, delegations.read, delegations.create, delegations.update, delegations.delete, api_keys.read, api_keys.create, api_keys.delete, agents.read, agents.create, agents.update, agents.delete, disputes.read, disputes.create` to `party.read, party.update, invite.read, invite.create, invite.update, invite.delete, membership.create, membership.read, membership.update, membership.delete, payments.create, payments.read, external_parties.create, external_parties.read, direct_payments.create, direct_payments.read, external_accounts.create, wallets.read, wallets.create, wallets.update, wallets.delete, wallets.fund, wallets.withdraw, delegations.read, delegations.create, delegations.update, delegations.delete, api_keys.read, api_keys.create, api_keys.delete, agents.read, agents.create, agents.update, agents.delete, disputes.read, disputes.create`
  - added the new `direct_payments.create` enum value to the request property `data/attributes/scopes/items/`
  - added the new `direct_payments.read` enum value to the request property `data/attributes/scopes/items/`
  - added the new `external_parties.create` enum value to the request property `data/attributes/scopes/items/`
  - added the new `external_parties.read` enum value to the request property `data/attributes/scopes/items/`
- **2026-07-26** `270e233e401c` — 1 breaking, 1 warning
  - the `data/attributes/name` request property's maxLength was decreased to `32`
  - added the new `UNKNOWN` enum value to the `data/attributes/status` response property for the response status `201`

---

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