Delete User

Permanently delete a user and all their associated data.

DELETE /api/v1/users/{id}

Authentication

Bearer Token

Version

Section

Users

Path Parameters * required

Name	Type	Required	Description
id*	string	✓	The unique identifier of the user to delete.

Request Headers

Header	Type	Required	Description
Authorization*	string	✓	Bearer token with `users:delete` scope.

Responses

Status	Description
204	User deleted successfully. No body returned.
401	Unauthorized.
403	Forbidden. Insufficient permissions.
404	User not found.

Examples

curl -X DELETE "https://api.example.com/v1/users/usr_abc123" \
  -H "Authorization: Bearer YOUR_TOKEN"

const res = await fetch('/api/v1/users/usr_abc123', {
  method: 'DELETE',
  headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
});
if (res.status === 204) {
  console.log('User deleted');
}

import requests

r = requests.delete(
    'https://api.example.com/v1/users/usr_abc123',
    headers={'Authorization': 'Bearer YOUR_TOKEN'}
)
assert r.status_code == 204