---
title: "Delete a key from the key store by alias or kid"
method: DELETE
path: "/keys/{aliasOrKid}"
tags: ["KMS"]
---

# Delete a key from the key store by alias or kid

`DELETE /keys/{aliasOrKid}`

Permanently removes a key identified by `aliasOrKid` (its alias or kid) from the calling tenant's key store. Pass the optional `providerId` query parameter to scope the deletion to a single provider. Returns 204 with no body on success, or 404 if no matching key exists.

## Response `204`

Key deleted successfully

## Other responses

- `404` — The requested resource was not found.
- `500` — An unexpected error occurred on the server.

---

[API](https://skmtc.dev/sphereon-opensource/apis/kms-rest-server-api.md) · [All operations](https://skmtc.dev/sphereon-opensource/apis/kms-rest-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sphereon-opensource/kms-rest-server-api/revisions/e9136cbde1c1/schema)