---
title: "Changes to Create a new API key for a workspace the user owns/admins; returns the secret key exactly once."
method: POST
path: "/api/v1/api-keys"
---

# Changes to Create a new API key for a workspace the user owns/admins; returns the secret key exactly once.

`POST /api/v1/api-keys`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 1 of 14 revisions.

- **2026-08-23** `155c812b368b` — 6 info

## Changes

- **2026-08-23** `155c812b368b` — 6 info
  - added the optional property `details` to the response with the `400` status
  - added the optional property `details` to the response with the `401` status
  - added the optional property `details` to the response with the `403` status
  - added the optional property `details` to the response with the `429` status
  - added the optional property `details` to the response with the `500` status
  - added the optional property `details` to the response with the `503` status

---

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