---
title: "Changes to Create an API key (returns the plaintext once)"
method: POST
path: "/v1/orgs/{orgId}/api-keys/create"
---

# Changes to Create an API key (returns the plaintext once)

`POST /v1/orgs/{orgId}/api-keys/create`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 64 revisions.

- **2026-10-26** `7fe59d94a9f5`: 3 info
- **2026-10-22** `551a288b9aa0`: 1 breaking, 1 warning, 2 info
- **2026-10-16** `5497aead7e4d`: 1 info
- **2026-10-16** `f53dbf66a389`: 2 info
- **2026-10-12** `f5f2b1004ded`: 1 warning
- **2026-10-10** `12b2fcbcc298`: 23 info

## Changes

- **2026-10-26** `7fe59d94a9f5`: 3 info
  - added the optional property `requestId` to the response with the `400` status
  - added the optional property `requestId` to the response with the `401` status
  - added the optional property `requestId` to the response with the `403` status
- **2026-10-22** `551a288b9aa0`: 1 breaking, 1 warning, 2 info
  - removed the enum value `service` of the request property `kind`
  - removed the optional property `serviceAccountId` from the response with the `200` status
  - request property `serviceAccountId` deprecated
  - removed the `service` enum value from the `kind` response property for the response status `200`
- **2026-10-16** `5497aead7e4d`: 1 info
  - added the new `org` enum value to the request property `kind`
- **2026-10-16** `f53dbf66a389`: 2 info
  - added the new optional request property `budget`
  - added the optional property `budget` to the response with the `200` status
- **2026-10-12** `f5f2b1004ded`: 1 warning
  - added the new `org` enum value to the `kind` response property for the response status `200`
- **2026-10-10** `12b2fcbcc298`: 23 info
  - added the new optional request property `ephemeral`
  - added the new optional request property `kind`
  - added the new optional request property `note`
  - added the new optional request property `permissions`
  - added the new optional request property `restrictions`
  - added the new optional request property `serviceAccountId`
  - added the new optional request property `template`
  - added the optional property `cedar` to the response with the `200` status
  - added the optional property `deniedBy` to the response with the `400` status
  - added the optional property `deniedBy` to the response with the `401` status
  - added the optional property `deniedBy` to the response with the `403` status
  - added the optional property `expiresAt` to the response with the `200` status
  - added the optional property `kind` to the response with the `200` status
  - added the optional property `ownerUserId` to the response with the `200` status
  - added the optional property `permission` to the response with the `400` status
  - added the optional property `permission` to the response with the `401` status
  - added the optional property `permission` to the response with the `403` status
  - added the optional property `permissions` to the response with the `200` status
  - added the optional property `policies` to the response with the `400` status
  - added the optional property `policies` to the response with the `401` status
  - added the optional property `policies` to the response with the `403` status
  - added the optional property `restrictions` to the response with the `200` status
  - added the optional property `serviceAccountId` to the response with the `200` status

---

[Operation](https://skmtc.dev/openrelay/apis/openrelay-api/docs/v1/orgs/:orgId/api-keys/create/post.md) - [API](https://skmtc.dev/openrelay/apis/openrelay-api.md) - [Page](https://skmtc.dev/openrelay/apis/openrelay-api/changes/v1/orgs/:orgId/api-keys/create/post)