Skip to main content

Request headers

string
required
The service user’s API token in the Bearer YOUR_TOKEN format. The school owner issues the token in the admin panel: Manage → School → For developers → API keys — see the “Authentication” section for details.
integer
required
The numeric ID of the seller — the account the school belongs to. Copy it on the API keys page, in the Integration data → Identifiers card. The token’s permissions are checked against this ID.
integer
required
The numeric ID of the school, found in the same place as Seller-Id. The value must match the seller’s school — otherwise a 400 error with cause: "ForbiddenSchoolMismatch" is returned.
This operation deletes users permanently. The school owner cannot be deleted: such IDs are skipped and returned in the skipped field.
A deleted user gets the Deleted status: credentials are wiped and sign-in is impossible, but the data is kept for reports. In user/list, you can find such users with the statuses=Deleted filter.
Deletion clears only email, phone and tgId, so you can reuse them for a new user right away. extId and domain stay with the deleted record: user/find by extId returns this user with the Deleted status, and creating a new user with the same extId or domain fails with ExtIdIsBusy / DomainIsBusy. If you need to reuse the identifier, reset it via user/update ("extId": null) before deletion.

Request parameters

The maximum number of users per request is 250. To delete more, make several requests.
integer[]
required
Array of numeric Exode user IDs (the id field from user/find or user/list). Up to 250 per request. Calling again with the same IDs is safe: already deleted users end up in skipped.
string
required
Reason for deletion. Up to 256 characters. Stored in the system for auditing.

Response fields

object

Permission requirements

Requires token authentication and the “School User Management” permission (SchoolManageUsers).

Updated: 2026-09-25 14:33 UTC