---
title: "Revoke an authorized client"
method: DELETE
path: "/platform/deployments/{id}/onion/clients/{name}"
tags: ["Platform"]
---

# Revoke an authorized client

`DELETE /platform/deployments/{id}/onion/clients/{name}`

## Request

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

Revokes one client. Removing the last client makes the onion
service public again. Revocation restarts the host's shared Tor
daemon briefly (invalidating existing rendezvous state is the
point). Requires the `manage` scope and `onion-auth-v1`.

## Path parameters

- `id` string, required
- `name` string, required

## Response `200`

Client revoked and resync enqueued.

## Other responses

- `401`: Invalid or missing API credentials
- `404`: Resource not found

---

[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)