---
title: "Revoke a credential and everything it minted"
method: DELETE
path: "/credentials/{id}"
tags: ["Account"]
---

# Revoke a credential and everything it minted

`DELETE /credentials/{id}`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/credentials/{id}`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Immediate, and it CASCADES: a kill switch that leaves the children
running is not a kill switch, so every credential minted by this one,
however deep, is revoked with it. The response lists every id that
was killed.

Revoking an already-revoked credential succeeds and reports nothing
killed — a kill switch should not fail because someone pressed it
twice.

## Path parameters

- `id` integer, required

## Response `200`

The ids that were revoked

## Other responses

- `404`: No such credential on this account

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)
