Delete a user

DELETE

/v1/server/users/{external_id}

curl --request DELETE \
  --url https://app.mondochat.io/v1/server/users/example \
  --header 'Authorization: Bearer <token>' \
  --header 'Mondochat-App-Id: <Mondochat-App-Id>'

Marks the user deleted and ends their sessions at once. Their messages, photos, IP records and profile fields are then removed within 24 hours, and the user.deleted webhook follows. Their peers see a deleted user and only their own messages. Server route: send the server secret as a bearer token with Mondochat-App-Id.

Errors: 404 not_found for an unknown or already deleted user.

Guide: Users.

Authorizations

• app_id
• server_secret

Parameters

Path Parameters

external_id

required

External Id

string

/^[A-Za-z0-9._:@-]{1,128}$/

Responses

202

Successful Response

Media typeapplication/json

Example ^generated

example

4XX

Problem

Media typeapplication/problem+json

An RFC 9457 problem: the body of every error answer.

object

code

required

The stable error code to branch on, such as policy_denied.

string

detail

What went wrong this time, when there is more to say.

string | null

errors

For validation, one entry per invalid field.

Array<object>

One invalid field.

object

loc

The path to the field.

array

msg

What is wrong with it.

string

instance

The path of the request.

string

reason

For policy_denied and limit_reached, the rule or limit that refused the request; for forbidden, a short cause such as you_blocked; for banned, temporary when the ban expires.

string

status

required

The HTTP status code.

integer

title

required

A short summary of the problem.

string

type

required

A URL that names the problem, https://app.mondochat.io/problems/<code>.

string

Example

{
  "code": "policy_denied",
  "detail": null,
  "instance": "/v1/conversations/0199d6a0-2000-7000-8000-000000000001",
  "reason": "pins",
  "status": 403,
  "title": "Policy denied",
  "type": "https://app.mondochat.io/problems/policy_denied"
}