---
title: "Deactivate a client"
method: DELETE
path: "/clients/{identifier}"
tags: ["clients"]
---

# Deactivate a client

`DELETE /clients/{identifier}`

Requires the privilege [`CLIENTS_WRITE`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Path parameters

- `identifier` string, required

## Query parameters

- `teamId` string, required

## Response `200`

Client successfully revoked

## Other responses

- `400` — Bad Request
- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege for target team: CLIENTS_WRITE
- `404` — Not Found

## Changes

- **2026-09-02** `358b43b8f258` — 1 breaking
  - removed the media type `text/plain` for the response with the status `200`

[Change history](https://skmtc.dev/gremlin/apis/gremlin-api/changes/clients/:identifier/delete.md)

---

[API](https://skmtc.dev/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.dev/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/revisions/358b43b8f258/schema)