Skip to content

Delete a sub-user

delete/sub-users/{subUserId}
Workspace keyDeletes

Delete a sub-user from the company. This also revokes any outstanding magic link or password setup tokens for the sub-user.

Requires the SSO Login add-on (see plans) and a workspace API key; without the add-on, or with a chatbot-scoped key, the request gets a 403.

Path parameters

Required
subUserIdstring
The unique identifier of the sub-user to delete.
Try it · DELETE /sub-users/{subUserId}
curl -X DELETE 'https://api.chat-data.com/api/v2/sub-users/6650f1c2a9e4b83d2c7a1f9a' \  -H "Authorization: Bearer $CHAT_DATA_API_KEY"
Loading…

Responses

Sub-user deleted successfully.

Content type: application/json

FieldDescription
statusstringOne of: ok.

Example

{  "status": "ok"}

Last updated October 14, 2026