# Disconnect a person with DELETE

October 21, 2026 · API

`DELETE /v1/users/:id` is open to every application, with its secret key.

## What changed

```
DELETE /v1/users/usr_4b8e9a01c2d3

→ 200
{ "id": "usr_4b8e9a01c2d3", "status": "revoked" }
```

Every build grant for the person stops working at once, and their standing agreement that your application places orders for them ends. Their Layout account, cards and orders stay theirs and are not deleted. Repeating the call answers the same. Provisioning the same number again later gives the same `id` back as a new invitation, and the person verifies again.

## Why it matters

When a person leaves your product, you can cut your application's access to them yourself, without asking them to disconnect you in Layout.

## What to do

Call it when a person closes their account with you. See [Disconnect a person](https://developer.layout.link/reference/provisioning#disconnect-a-person).

## Breaking changes

None.
