---
title: "Changes to Create API Key"
method: POST
path: "/v0/pods/{pod_id}/api-keys"
---

# Changes to Create API Key

`POST /v0/pods/{pod_id}/api-keys`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 38 revisions.

- **2026-10-16** `3f5c7830c952`: 1 breaking, 4 warning, 26 info
- **2026-07-15** `394ddcdd9c29`: 7 info
- **2026-04-08** `69e3767c5ada`: 2 info
- **2026-03-31** `27965096e618`: 1 info
- **2026-03-28** `8a5b5e92ae2d`: 1 breaking
- **2026-03-23** `add9c40c7e57`: 70 warning, 70 info
- **2026-03-23** `ec0967a2d85d`: 2 info
- **2026-03-18** `f49e3de8fad0`: 1 info
- **2026-03-06** `161e9f5d786c`: 1 info

## Changes

- **2026-10-16** `3f5c7830c952`: 1 breaking, 4 warning, 26 info
  - the request's body type changed from `object` to no type
  - removed the request property `name`
  - removed the request property `permissions`
  - removed the optional property `permissions/thread_delete` from the response with the `200` status
  - removed the optional property `permissions/thread_read` from the response with the `200` status
  - the endpoint scheme security `Bearer` was added to the API
  - the endpoint scheme security `BearerAuth` was removed from the API
  - api tag `pods > api-keys` added
  - api tag `PodsApiKeys` removed
  - request body became optional
  - added `#/components/schemas/apiKeys_CreateBearerApiKeyRequest, #/components/schemas/apiKeys_CreatePublicKeyRequest` to the request body `oneOf` list
  - added the optional property `expires_at` to the response with the `200` status
  - added the optional property `permissions/account_update` to the response with the `200` status
  - added the optional property `permissions/agent_armor_release` to the response with the `200` status
  - added the optional property `permissions/api_key_update` to the response with the `200` status
  - added the optional property `permissions/app_connect` to the response with the `200` status
  - added the optional property `permissions/app_share_owner` to the response with the `200` status
  - added the optional property `permissions/calendar_event_create` to the response with the `200` status
  - added the optional property `permissions/calendar_event_delete` to the response with the `200` status
  - added the optional property `permissions/calendar_event_read` to the response with the `200` status
  - added the optional property `permissions/calendar_event_update` to the response with the `200` status
  - added the optional property `permissions/calendar_read` to the response with the `200` status
  - added the optional property `permissions/calendar_update` to the response with the `200` status
  - added the optional property `permissions/file_create` to the response with the `200` status
  - added the optional property `permissions/file_delete` to the response with the `200` status
  - added the optional property `permissions/file_read` to the response with the `200` status
  - added the optional property `permissions/file_update` to the response with the `200` status
  - added the optional property `permissions/label_unauthenticated_read` to the response with the `200` status
  - added the optional property `permissions/message_delete` to the response with the `200` status
  - added the optional property `permissions/message_reply` to the response with the `200` status
  - added the optional property `permissions/pod_update` to the response with the `200` status
- **2026-07-15** `394ddcdd9c29`: 7 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `404` status
  - added the optional property `docs` to the response with the `400` status
  - added the optional property `docs` to the response with the `404` status
  - added the optional property `fix` to the response with the `400` status
  - added the optional property `fix` to the response with the `404` status
  - added the optional property `message` to the response with the `400` status
- **2026-04-08** `69e3767c5ada`: 2 info
  - the request property `name` became nullable
  - the request property `name` became optional
- **2026-03-31** `27965096e618`: 1 info
  - endpoint added
- **2026-03-28** `8a5b5e92ae2d`: 1 breaking
  - api path removed without deprecation
- **2026-03-23** `add9c40c7e57`: 70 warning, 70 info
  - removed the request property `permissions/create_api_key`
  - removed the request property `permissions/create_domain`
  - removed the request property `permissions/create_draft`
  - removed the request property `permissions/create_inbox`
  - removed the request property `permissions/create_list_entry`
  - removed the request property `permissions/create_pod`
  - removed the request property `permissions/create_webhook`
  - removed the request property `permissions/delete_api_key`
  - removed the request property `permissions/delete_domain`
  - removed the request property `permissions/delete_draft`
  - removed the request property `permissions/delete_inbox`
  - removed the request property `permissions/delete_list_entry`
  - removed the request property `permissions/delete_pod`
  - removed the request property `permissions/delete_thread`
  - removed the request property `permissions/delete_webhook`
  - removed the request property `permissions/read_api_key`
  - removed the request property `permissions/read_blocked`
  - removed the request property `permissions/read_domain`
  - removed the request property `permissions/read_draft`
  - removed the request property `permissions/read_inbox`
  - removed the request property `permissions/read_list_entry`
  - removed the request property `permissions/read_message`
  - removed the request property `permissions/read_metrics`
  - removed the request property `permissions/read_pod`
  - removed the request property `permissions/read_spam`
  - removed the request property `permissions/read_thread`
  - removed the request property `permissions/read_trash`
  - removed the request property `permissions/read_webhook`
  - removed the request property `permissions/send_draft`
  - removed the request property `permissions/send_message`
  - removed the request property `permissions/update_domain`
  - removed the request property `permissions/update_draft`
  - removed the request property `permissions/update_inbox`
  - removed the request property `permissions/update_message`
  - removed the request property `permissions/update_webhook`
  - removed the optional property `permissions/create_api_key` from the response with the `200` status
  - removed the optional property `permissions/create_domain` from the response with the `200` status
  - removed the optional property `permissions/create_draft` from the response with the `200` status
  - removed the optional property `permissions/create_inbox` from the response with the `200` status
  - removed the optional property `permissions/create_list_entry` from the response with the `200` status
  - …100 more
- **2026-03-23** `ec0967a2d85d`: 2 info
  - added the new optional request property `permissions`
  - added the optional property `permissions` to the response with the `200` status
- **2026-03-18** `f49e3de8fad0`: 1 info
  - added the optional property `inbox_id` to the response with the `200` status
- **2026-03-06** `161e9f5d786c`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/agentmail-to/apis/api/docs/v0/pods/:pod_id/api-keys/post.md) - [API](https://skmtc.dev/agentmail-to/apis/api.md) - [Page](https://skmtc.dev/agentmail-to/apis/api/changes/v0/pods/:pod_id/api-keys/post)
