Skip to main content
DELETE
/
platform
/
api
/
v1
/
users
/
{id}
Delete a User
curl --request DELETE \
  --url https://app.chatwoot.com/platform/api/v1/users/{id} \
  --header 'api_access_token: <api-key>'
{
  "description": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>",
      "code": "<string>"
    }
  ]
}

​
Behavior

  • Returns 204 No Content on success
  • Consider setting is_active: false instead to preserve audit trail
  • This action is permanent and cannot be undone

Authorizations

​
api_access_token
string
header
required

This token can be obtained by the system admin after creating a platformApp. This token should be used to provision agent bots, accounts, users and their roles.

Path Parameters

​
id
integer
required

The numeric ID of the user on the platform

Response

Success