Skip to main content

Обновить пользователя

PUT /users/:user_id/


Пример URL

https://домен_системы/api/v2/users/123/


PATH-параметры

ПараметрТипОбязательныйОписание
user_idчислоДаID пользователя

Параметры тела запроса (JSON)

ПараметрТипОбязательныйОписание
nameстрокаНетИмя пользователя
emailстрокаНетЭ-почта пользователя
passwordстрокаНетПароль пользователя
group_idчислоНетID группы пользователя
departmentмассивНетID доступных департаментов
lastnameстрокаНетФамилия
aliasстрокаНетПсевдоним
phoneстрокаНетТелефон
skypeстрокаНетСкайп
websiteстрокаНетАдрес сайта
organizationстрокаНетНазвание новой или существующей компании; Если заполнено — поле "organiz_id" не учитывается
organiz_idчислоНетID существующей компании; Не учитывается, если заполнено "organization"
statusстрокаНетСтатус пользователя: active - активен; disabled - заблокирован; fired - уволен
languageстрокаНетЯзык пользователя
notificationsbooleanНетУведомления на почту: 0 - отключены; 1 - включены
user_statusстрокаНетСтатус активности пользователя
custom_fieldsобъектНетМассив индивидуальных полей контактов

Пример тела запроса (JSON)

{
"name":"Иван",
"email":"email@example.com",
"department":[1],
"password":"abc123",
"group_id": 1,
"lastname":"Иванов", // для указания пустого значения ""
"phone": "+7 123 123‒45‒67", // для указания пустого значения ""
"skype":"skype", // для указания пустого значения ""
"website":"example.com", // для указания пустого значения ""
"organization":"Новая организация", // для указания пустого значения ""
// "organiz_id":1, // Не учитывается, если заполнено "organization"
"status":"active",
"language":"ru",
"notifications":0,
"user_status":"online",
"custom_fields":{
"113": "Значение поля с типом (Текстовое поле)", // Пример для поля c типом "Текстовое поле" (ID = 113), для установки пустого значения указать ""
"114": "Значение поля с типом (Текстовая область)", // Пример для поля с типом "Текстовая область" (ID = 114), для установки пустого значения указать ""
"115": "450", // Пример для поля с типом "Выпадающий список" (ID = 115), необходимо указать ID значений из поля, для установки пустого значения указать ""
"116":{ // Пример поля с типом "Связанные поля" (ID = 116)
"1": 452, // Значение ID-поля первого уровня
"2": 454 // Значение ID-поля второго уровня
},
// "116":{
// "1": 0, // Структура для указания пустового значения с типом "Связанные поля"
// }
"117": "1", // Пример для поля с типом "Флажок (чекбокс)" (ID = 117), для установки пустого значения указать ""
"118": "01.01.2027", // Пример для поля с типом "Дата" (ID = 118), для установки пустого значения указать ""
"119": "1" // Пример поля с типом "Числовое поле" (ID = 119), для установки пустого значения указать ""
}
}

Пример ответа
{
"data": {
"id": 1,
"date_created": "2025-10-17 11:08:43",
"date_updated": "2025-10-17 11:08:43",
"name": "Иван",
"lastname": "Иванов",
"alias": "Техническая поддержка",
"email": "email@example.com",
"phone": "+7 123 123‒45‒67",
"skype": "skype",
"website": "example.com",
"organization": {
"id": "1",
"name": "Новая организация",
"domains": "",
"address": "",
"phone": "",
"email": "",
"web": ""
},
"status": "active",
"language": "ru",
"notifications": "1",
"group": {
"id": 1,
"type": "user",
"name": {
"ru": "Клиент",
"en": "Client",
"ua": "-"
},
"disable": 0
},
"ldap_username": null,
"user_status": "online",
"department": [
1
],
"custom_fields": [
{
"id": 113,
"field_type": "text",
"field_value": "Значение поля с типом (Текстовое поле)"
},
{
"id": 114,
"field_type": "textarea",
"field_value": "Значение поля с типом (Текстовая область)"
},
{
"id": 115,
"field_type": "select",
"field_value": {
"id": 450,
"name": {
"ru": "Значение 1",
"en": "",
"ua": ""
}
}
},
{
"id": 116,
"field_type": "hierarchy",
"field_value": {
"1": {
"id": 452,
"name": {
"ru": "Родительский элемент первого уровня"
}
},
"2": {
"id": 454,
"name": {
"ru": "Дочерний элемент второго уровня"
}
}
}
},
{
"id": 117,
"field_type": "checkbox",
"field_value": 1
},
{
"id": 118,
"field_type": "date",
"field_value": "01.01.2027"
},
{
"id": 119,
"field_type": "number",
"field_value": "1"
}
]
}
}