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

# Changes to Create an API key

`POST /v2/api-keys`

> Every recorded change to this endpoint, newest first.
> 16 revisions in range; 1 not diffed.

## Timeline

Changed in 2 of 16 revisions.

- **2026-08-15** `be2f226a6d2c` — 1 breaking, 3 info
- **2026-08-07** `1e87d8a4cf69` — 3 breaking, 3 warning

## Changes

- **2026-08-15** `be2f226a6d2c` — 1 breaking, 3 info
  - added `#/components/schemas/CreatedUserApiKey, #/components/schemas/CreatedServiceApiKey` to the response body `oneOf` list for the response status `201`
  - mapped value for key `SERVICE` changed from `#/components/schemas/ServiceApiKeyCreated` to `#/components/schemas/CreatedServiceApiKey` from the response discriminator for the response status `201`
  - mapped value for key `USER` changed from `#/components/schemas/UserApiKeyCreated` to `#/components/schemas/CreatedUserApiKey` from the response discriminator for the response status `201`
  - removed `#/components/schemas/UserApiKeyCreated, #/components/schemas/ServiceApiKeyCreated` from the response body `oneOf` list for the response status `201`
- **2026-08-07** `1e87d8a4cf69` — 3 breaking, 3 warning
  - added `#/components/schemas/OrganizationRoleAssignmentRequest` to the `oneOf[#/components/schemas/CreateServiceApiKeyRequest]/organizations/items/role` request property `allOf` list
  - added `#/components/schemas/SpaceRoleAssignmentRequest` to the `oneOf[#/components/schemas/CreateServiceApiKeyRequest]/organizations/items/spaces/items/role` request property `allOf` list
  - added `#/components/schemas/UserRoleAssignmentRequest` to the `oneOf[#/components/schemas/CreateServiceApiKeyRequest]/account_role` request property `allOf` list
  - removed `#/components/schemas/OrganizationRoleAssignment` from the `oneOf[#/components/schemas/CreateServiceApiKeyRequest]/organizations/items/role` request property `allOf` list
  - removed `#/components/schemas/SpaceRoleAssignment` from the `oneOf[#/components/schemas/CreateServiceApiKeyRequest]/organizations/items/spaces/items/role` request property `allOf` list
  - removed `#/components/schemas/UserRoleAssignment` from the `oneOf[#/components/schemas/CreateServiceApiKeyRequest]/account_role` request property `allOf` list

---

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