> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exode.biz/llms.txt
> Use this file to discover all available pages before exploring further.
# Обновление пользователя
> Обновление данных существующего пользователя в школе с изменением данных профиля
## Заголовки запроса
API-токен сервисного пользователя в формате `Bearer YOUR_TOKEN`. Токен выпускает владелец школы в кабинете:
**Управление → Школа → Для разработчиков → API-ключи** — подробнее в разделе [«Аутентификация»](/ru/exode-api/setup#аутентификация).
Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице **API-ключи** в
карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.
Числовой ID школы, берётся там же, где `Seller-Id`. Значение должно совпадать со школой продавца — иначе
вернётся ошибка `400` с `cause: "ForbiddenSchoolMismatch"`.
```
PUT /saas/v2/user/:userId/update
```
Требуется аутентификация и право [**«Управление пользователями школы»**](/ru/exode-api/permissions) (`SchoolManageUsers`).
## Параметры запроса
##### При обновлении все поля необязательны для заполнения. Если поле необходимо удалить и оно может быть пустым — передавайте `null`
`userId` — числовой ID пользователя в Exode (поле `id` в ответе [`user/create`](/ru/exode-api/school/user/create),
[`user/find`](/ru/exode-api/school/user/find) или [`user/list`](/ru/exode-api/school/user/list)). Если вы храните
у себя только свой идентификатор — используйте вариант
[по внешнему идентификатору](#обновление-пользователя-по-внешнему-идентификатору) `extId`.
Пароль этим методом изменить нельзя. Если пользователя с таким `userId` нет в школе из заголовка `School-Id`,
вернётся `401` с `cause: "Forbidden"` и сообщением `seller not entity owner`.
Email адрес пользователя. Должен быть валидным email форматом. При передаче пустой строки — преобразуется в
`null`.
Номер телефона пользователя. Должен быть в международном формате (например, +9876543210). При передаче пустой строки — преобразуется в `null`.
Доменный логин пользователя. До 65 символов: латинские буквы, цифры, `_` и точки — точка не может быть первой/последней и не может
идти подряд (автоматически приводится к нижнему
регистру). Должен быть уникальным в рамках школы. Используется для входа наряду с `email` и `phone`.
Telegram ID пользователя. Целое число или `null`. Логином не является — используется для связи аккаунта с Telegram.
Внешний идентификатор пользователя из вашей системы. Строка до 50 символов или `null` (пустая строка сбрасывает
значение в `null`). Логином не является — используется только для связи с вашей CRM/LMS и поиска пользователя.
Статус учётной записи: `Active`, `OnLeave`, `Banned`, `Blocked` или `Terminated`.
* `Active` — обычный доступ;
* `OnLeave` — «в отсутствии»: информационный статус, доступ **не блокирует**. Управляется автоматически модулем
[отсутствий](/ru/exode-api/school/staff/absence) — вручную устанавливать не рекомендуется;
* `Banned` — забанен: вход запрещён, активные сессии завершаются. Чтобы снять бан — передайте `Active`:
фактический статус пересчитается автоматически по трудоустройствам и отсутствиям (`Terminated` / `OnLeave` /
`Active`), поэтому уволенный до бана сотрудник не получит доступ по ошибке;
* `Blocked` — заблокирован: вход запрещён, активные сессии завершаются, зачисления на продукты блокируются.
Возврат в `Active` восстанавливает доступ;
* `Terminated` — уволен: доступ закрыт так же, как у `Blocked`. Управляется автоматически модулем
[трудоустройств](/ru/exode-api/school/staff/employment) (увольнение с последнего активного трудоустройства);
при увольнении используйте `staff/employment/terminate`, а не прямую установку статуса.
Статус `Deleted` зарезервирован системой (удаление аккаунта) — передать его нельзя.
Булево поле `banned` из запроса **удалено** — блокировка управляется только через `status` (`Banned` /
`Blocked`). В ответе поля `banned` и `active` по-прежнему присутствуют как производные от `status`.
Владелец школы защищён: другой администратор не может изменить его данные, а перевод владельца в блокирующий
статус (`Banned`/`Blocked`/`Terminated`) запрещён даже для него самого — вернётся ошибка
`ForbiddenModifySchoolOwner`.
Контейнер связанных данных — как в
[`user/create`](/ru/exode-api/school/user/create#дополнительные-агрегаты-extra): блок `staff.employments`
(массив 1–10). Только для корпоративных школ; в отличие от создания — **необязателен**. Трудоустройства
применяются идемпотентно: повторная передача той же активной пары департамент + должность не создаёт дубль.
Через `extra` в `update` можно только **донанять** сотрудника. Переводы, смена должности и увольнение —
через эндпоинты раздела [Сотрудники (HR)](/ru/exode-api/school/staff/employment).
### Параметры профиля
Объект с данными профиля пользователя для обновления.
Имя пользователя. От 2 до 15 символов: буквы (латиница и кириллица, включая ў/ғ/қ/ҳ), пробелы и апострофы
(например, `O'Brien`). Автоматически обрезаются пробелы в начале и конце.
Фамилия пользователя. От 2 до 15 символов: буквы (латиница и кириллица, включая ў/ғ/қ/ҳ), пробелы и апострофы
(например, `O'Brien`). Автоматически обрезаются пробелы в начале и конце.
Дата рождения в формате YYYY-MM-DD.
Пол пользователя. Возможные значения: `Ufo`, `Women`, `Men`.
Роль пользователя. Возможные значения: `Student`, `Tutor`, `Parent`.
При обновлении пользователя можно изменить как основные данные, так и данные профиля. Если профиль не указан,
то соответственно, он остается без изменений.
```bash cURL theme={null}
curl --location --request PUT 'https://api.exode.biz/saas/v2/user/123/update' \
--header 'Seller-Id: {{ sellerId }}' \
--header 'School-Id: {{ schoolId }}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--data-raw '{
"email": "updated@example.com",
"phone": "+9876543210",
"extId": "crm_12345",
"tgId": null,
"status": "Active",
"profile": {
"firstName": "Newfirstname",
"lastName": "Newlastname",
"bdate": "1990-01-01",
"sex": "Men",
"role": "Student"
}
}'
```
```javascript Node.js theme={null}
const axios = require('axios');
const updateUser = async (userId) => {
try {
const response = await axios.put(`https://api.exode.biz/saas/v2/user/${userId}/update`, {
email: 'updated@example.com',
phone: '+9876543210',
extId: 'crm_12345',
tgId: null,
status: 'Active',
profile: {
firstName: 'Newfirstname',
lastName: 'Newlastname',
bdate: '1990-01-01',
sex: 'Men',
role: 'Student'
}
}, {
headers: {
'Seller-Id': '{{ sellerId }}',
'School-Id': '{{ schoolId }}',
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_TOKEN'
}
});
console.log('User updated:', response.data.payload);
} catch (error) {
console.error('Error:', error.response?.data || error.message);
}
};
updateUser(123);
```
```php PHP theme={null}
'updated@example.com',
'phone' => '+9876543210',
'extId' => 'crm_12345',
'tgId' => null,
'status' => 'Active',
'profile' => [
'firstName' => 'Newfirstname',
'lastName' => 'Newlastname',
'bdate' => '1990-01-01',
'sex' => 'Men',
'role' => 'Student'
]
];
$headers = [
'Seller-Id: {{ sellerId }}',
'School-Id: {{ schoolId }}',
'Content-Type: application/json',
'Authorization: Bearer YOUR_TOKEN'
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode === 200) {
$result = json_decode($response, true);
echo "User updated successfully\n";
print_r($result['payload']);
} else {
echo "Error: HTTP $httpCode\n";
echo $response;
}
?>
```
```python Python theme={null}
import requests
import json
user_id = 123
url = f'https://api.exode.biz/saas/v2/user/{user_id}/update'
data = {
'email': 'updated@example.com',
'phone': '+9876543210',
'extId': 'crm_12345',
'tgId': None,
'status': 'Active',
'profile': {
'firstName': 'Newfirstname',
'lastName': 'Newlastname',
'bdate': '1990-01-01',
'sex': 'Men',
'role': 'Student'
}
}
headers = {
'Seller-Id': '{{ sellerId }}',
'School-Id': '{{ schoolId }}',
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_TOKEN'
}
try:
response = requests.put(url, json=data, headers=headers)
response.raise_for_status()
result = response.json()
print('User updated successfully:')
print(json.dumps(result['payload'], indent=2, ensure_ascii=False))
except requests.exceptions.RequestException as e:
print(f'Error: {e}')
if hasattr(e, 'response') and e.response is not None:
print(f'Response: {e.response.text}')
```
```bsl 1С theme={null}
Профиль = Новый Структура;
Профиль.Вставить("firstName", "Newfirstname");
Профиль.Вставить("lastName", "Newlastname");
Профиль.Вставить("bdate", "1990-01-01");
Профиль.Вставить("sex", "Men");
Профиль.Вставить("role", "Student");
Данные = Новый Структура;
Данные.Вставить("email", "updated@example.com");
Данные.Вставить("phone", "+9876543210");
Данные.Вставить("extId", "crm_12345");
Данные.Вставить("tgId", Неопределено);
Данные.Вставить("status", "Active");
Данные.Вставить("profile", Профиль);
// Serialize body to JSON
ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ЗаписатьJSON(ЗаписьJSON, Данные);
ТелоЗапроса = ЗаписьJSON.Закрыть();
Соединение = Новый HTTPСоединение("api.exode.biz", 443, , , , 30, Новый OpenSSLSecureConnection);
Запрос = Новый HTTPЗапрос("/saas/v2/user/123/update");
Запрос.Заголовки.Вставить("Seller-Id", "{{ sellerId }}");
Запрос.Заголовки.Вставить("School-Id", "{{ schoolId }}");
Запрос.Заголовки.Вставить("Content-Type", "application/json");
Запрос.Заголовки.Вставить("Authorization", "Bearer YOUR_TOKEN");
Запрос.УстановитьТелоИзСтроки(ТелоЗапроса);
Ответ = Соединение.ВызватьHTTPМетод("PUT", Запрос);
Если Ответ.КодСостояния = 200 Тогда
ЧтениеJSON = Новый ЧтениеJSON;
ЧтениеJSON.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку());
Результат = ПрочитатьJSON(ЧтениеJSON);
Сообщить("Пользователь обновлён");
Иначе
Сообщить("Ошибка: HTTP " + Ответ.КодСостояния);
Сообщить(Ответ.ПолучитьТелоКакСтроку());
КонецЕсли;
```
```json Success theme={null}
{
"success": true,
"code": 200,
"payload": {
"user": {
"id": 1683,
"createdAt": "2026-07-02T11:15:46.896Z",
"updatedAt": "2026-07-02T11:15:46.980Z",
"archivedAt": null,
"uuid": "e-cjTT0CWMCB",
"active": true,
"activated": true,
"banned": false,
"status": "Active",
"alive": true,
"domain": "id1683",
"email": "updated@example.com",
"phone": "+9876543210",
"tgId": null,
"vkId": null,
"appleId": null,
"extId": "crm_12345",
"schoolId": 198,
"language": null,
"timezone": null,
"lastOnlineAt": null,
"starsBalance": 0,
"currentTime": "2026-07-02T11:15:46+00:00",
"isSleepingNow": false,
"profile": {
"id": 1665,
"createdAt": "2026-07-02T11:15:46.932Z",
"updatedAt": "2026-07-02T11:15:46.976Z",
"archivedAt": null,
"userId": 1683,
"official": false,
"firstName": "Newfirstname",
"lastName": "Newlastname",
"fullName": "Newfirstname Newlastname",
"fullNameShort": "Newfirstname N.",
"bdate": "1990-01-01",
"sex": "Men",
"country": null,
"city": null,
"role": "Student",
"status": null,
"title": "",
"emojiTitle": "",
"avatar": {
"id": 1665,
"small": "https://storage.exode.biz/production/user/1683/xK2mVwNib9b0/small/avatar.png",
"medium": "https://storage.exode.biz/production/user/1683/xK2mVwNib9b0/medium/avatar.png",
"maximum": "https://storage.exode.biz/production/user/1683/xK2mVwNib9b0/avatar.png"
},
"titleState": {
"manualTitle": null,
"manualEmojiTitle": null,
"manualNextTitle": null,
"manualNextEmojiTitle": null,
"manualExpiredAt": null,
"locationTitle": null,
"locationEmojiTitle": null,
"achievementTitle": null,
"achievementEmojiTitle": null
}
}
}
}
}
```
```json Error - User Not Found / Other School theme={null}
{
"code": 401,
"success": false,
"cause": "Forbidden",
"message": "Forbidden seller resource - seller not entity owner",
"error": "Forbidden seller resource - seller not entity owner"
}
```
```json Error - Email Is Busy theme={null}
{
"code": 400,
"success": false,
"cause": "EmailIsBusy",
"message": "Email is busy",
"error": "Email is busy"
}
```
```json Error - Phone Is Busy theme={null}
{
"code": 400,
"success": false,
"cause": "PhoneIsBusy",
"message": "Phone is busy",
"error": "Phone is busy"
}
```
```json Error - Telegram ID Is Busy theme={null}
{
"code": 400,
"success": false,
"cause": "TgIdIsBusy",
"message": "Tg id is busy",
"error": "Tg id is busy"
}
```
```json Error - Domain Is Busy theme={null}
{
"code": 400,
"success": false,
"cause": "DomainIsBusy",
"message": "This domain is already taken",
"error": "This domain is already taken"
}
```
```json Error - Domain Is Invalid theme={null}
{
"code": 400,
"success": false,
"cause": "DomainIsInvalid",
"message": "Domain is invalid",
"error": "Domain is invalid"
}
```
```json Error - Invalid Email theme={null}
{
"code": 400,
"success": false,
"cause": "validation",
"message": [
"email must be an email"
],
"error": "Bad Request"
}
```
```json Error - Invalid Phone theme={null}
{
"code": 400,
"success": false,
"cause": "validation",
"message": [
"phone must be a valid phone number"
],
"error": "Bad Request"
}
```
```json Error - Invalid First Name theme={null}
{
"code": 400,
"success": false,
"cause": "validation",
"message": [
"profile.firstName must be shorter than or equal to 15 characters"
],
"error": "Bad Request"
}
```
```json Error - Forbidden Modify School Owner theme={null}
{
"code": 400,
"success": false,
"cause": "ForbiddenModifySchoolOwner",
"message": "Not allowed to modify school owner",
"error": "Not allowed to modify school owner"
}
```
## Обновление пользователя по внешнему идентификатору
```
PUT /saas/v2/user/ext/{extId}/update
```
Требуется аутентификация и право **«Управление пользователями школы»** (`SchoolManageUsers`).
То же самое, что и обновление по `userId`, но пользователь адресуется по внешнему идентификатору `extId`
в рамках школы — удобно для интеграций (CRM/1С), где внутренние id Exode не хранятся. Тело запроса, ответ,
защита владельца школы и поддержка `extra` — идентичны обычному `update`.
### Параметры
Внешний идентификатор пользователя в рамках школы. Не может содержать `/` и пробельные символы;
не-ASCII значения (кириллица и т.п.) в пути должны быть **URL-encoded** (`encodeURIComponent`).
```bash cURL theme={null}
curl --location --request PUT 'https://api.exode.biz/saas/v2/user/ext/i.ivanov.01011990/update' \
--header 'Seller-Id: {{ sellerId }}' \
--header 'School-Id: {{ schoolId }}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--data-raw '{
"email": "updated@example.com",
"profile": {
"firstName": "Newfirstname"
}
}'
```
```javascript Node.js theme={null}
const axios = require('axios');
const updateUserByExtId = async (extId) => {
const { data } = await axios.put(
`https://api.exode.biz/saas/v2/user/ext/${encodeURIComponent(extId)}/update`,
{
email: 'updated@example.com',
profile: {
firstName: 'Newfirstname',
},
},
{
headers: {
'Seller-Id': '{{ sellerId }}',
'School-Id': '{{ schoolId }}',
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_TOKEN',
},
}
);
console.log(data.payload.user);
};
updateUserByExtId('i.ivanov.01011990');
```
```json Error - User Not Found theme={null}
{
"code": 400,
"success": false,
"cause": "NotFound",
"message": "User not found",
"error": "User not found"
}
```
## Требования к правам доступа
Для обновления пользователя требуется право **«Управление пользователями школы»** (`SchoolManageUsers`).
Сервисный пользователь должен быть аутентифицирован по токену и иметь соответствующие права доступа к указанной
школе.
При установке блокирующего статуса (`Banned`/`Blocked`/`Terminated`) все активные сессии пользователя
**автоматически завершаются** — это
реализовано для обеспечения безопасности.
***
*Обновлено: 2026-09-25 13:43 UTC*
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.