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.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
integer[]
required
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