Изменить информацию

Изменяет информацию о сотруднике. Изменяются значения только тех параметров, которые были переданы в запросе.

Примечание

Требуется разрешение на изменение данных о сотрудниках.

Request

PATCH

https://api360.yandex.net/directory/v1/org/{orgId}/users/{userId}

Path parameters

Name

Description

orgId

Type: integer

Идентификатор организации.

userId

Type: string<uint64>

Идентификатор сотрудника.

Example: ``

Body

application/json

{
  "nickname": "example",
  "departmentId": 0,
  "name": {
    "first": "example",
    "last": "example",
    "middle": "example"
  },
  "gender": "example",
  "position": "example",
  "about": "example",
  "birthday": "1999-11-22",
  "contacts": [
    {
      "type": "example",
      "value": "example",
      "label": "example"
    }
  ],
  "externalId": "example",
  "isAdmin": true,
  "isEnabled": true,
  "timezone": "example",
  "language": "example",
  "password": "example",
  "passwordChangeRequired": true,
  "displayName": "example"
}

Name	Description
about	Type: string Описание сотрудника. Example: `example`
birthday	Type: string<date> Дата рождения сотрудника. Формат `YYYY-MM-DD`. Pattern: `^\d{4}-\d{2}-\d{2}$` Example: `1999-11-22`
contacts	Type: v1UserContactParams[] Список контактов сотрудника. Example `[ { "type": "example", "value": "example", "label": "example" } ]`
departmentId	Type: integer Идентификатор подразделения сотрудника.
displayName	Type: string Публичное имя сотрудника – имя, которое сотрудник использует в своем профиле для представления себя, оно может совпадать с реальным именем, быть псевдонимом или никнеймом. Example: `example`
externalId	Type: string Произвольный внешний идентификатор сотрудника. Example: `example`
gender	Type: string Пол сотрудника. Example: `example`
isAdmin	Type: boolean Признак администратора организации: `true` — администратор; `false` — рядовой пользователь.
isEnabled	Type: boolean Статус аккаунта сотрудника: `true` — активен; `false` — заблокирован.
language	Type: string Язык сотрудника. Example: `example`
name	Type: v1UserNameParams ФИО сотрудника. Example `{ "first": "example", "last": "example", "middle": "example" }`
nickname	Type: string Логин сотрудника. Example: `example`
password	Type: string Пароль сотрудника. Example: `example`
passwordChangeRequired	Type: boolean Обязательность изменения пароля при первом входе: `true` — обязательно; `false` — необязательно.
position	Type: string Должность сотрудника. Example: `example`
timezone	Type: string Часовой пояс сотрудника. Example: `example`

v1UserNameParams

ФИО сотрудника.

Name	Description
first	Type: string Имя сотрудника. Example: `example`
last	Type: string Фамилия сотрудника. Example: `example`
middle	Type: string Отчество сотрудника. Example: `example`

Example

{
  "first": "example",
  "last": "example",
  "middle": "example"
}

v1UserContactParams

Контакты сотрудника.

Name	Description
type	Type: string Тип контакта. Возможные значения: `email`; `phone_extension`; `phone`; `site`; `icq`; `twitter`; `skype`. Example: `example`
value	Type: string Значение контакта. Example: `example`
label	Type: string Произвольная метка контакта. Example: `example`

Example

{
  "type": "example",
  "value": "example",
  "label": "example"
}

Responses

200 OK

Запрос успешно выполнен.

Body

application/json

{
  "id": "example",
  "nickname": "example",
  "departmentId": 0,
  "email": "example",
  "name": {
    "first": "example",
    "last": "example",
    "middle": "example"
  },
  "gender": "example",
  "position": "example",
  "avatarId": "example",
  "about": "example",
  "birthday": "example",
  "contacts": [
    {
      "type": "example",
      "value": "example",
      "main": true,
      "alias": true,
      "synthetic": true,
      "label": "example"
    }
  ],
  "aliases": [
    "example"
  ],
  "groups": [
    0
  ],
  "externalId": "example",
  "isAdmin": true,
  "isRobot": true,
  "isDismissed": true,
  "isEnabled": true,
  "isEnabledUpdatedAt": "2025-01-01T00:00:00Z",
  "timezone": "example",
  "language": "example",
  "createdAt": "2025-01-01T00:00:00Z",
  "updatedAt": "2025-01-01T00:00:00Z",
  "displayName": "example"
}

Name	Description
about	Type: string Описание сотрудника. Example: `example`
aliases	Type: string[] Список алиасов сотрудника. Example `[ "example" ]`
avatarId	Type: string Идентификатор портрета сотрудника. Example: `example`
birthday	Type: string Дата рождения сотрудника. В формате `YYYY-MM-DD` или пустая строка. Example: `example`
contacts	Type: v1UserContact[] Список контактов сотрудника. Example `[ { "type": "example", "value": "example", "main": true, "alias": true, "synthetic": true, "label": "example" } ]`
createdAt	Type: string<date-time> Дата и время создания сотрудника. Example: `2025-01-01T00:00:00Z`
departmentId	Type: integer Идентификатор подразделения, в котором состоит сотрудник.
displayName	Type: string Публичное имя сотрудника – имя, которое сотрудник использует в своем профиле для представления себя, оно может совпадать с реальным именем, быть псевдонимом или никнеймом. Example: `example`
email	Type: string Основной адрес электронной почты сотрудника. Example: `example`
externalId	Type: string Произвольный внешний идентификатор сотрудника. Example: `example`
gender	Type: string Пол сотрудника. Example: `example`
groups	Type: integer[] Идентификаторы групп, в которых состоит сотрудник. Example `[ 0 ]`
id	Type: string<uint64> Идентификатор сотрудника. Example: `example`
isAdmin	Type: boolean Признак администратора организации: `true` — администратор; `false` — рядовой пользователь.
isDismissed	Type: boolean Статус сотрудника: `true` — уволенный; `false` — действующий.
isEnabled	Type: boolean Статус аккаунта сотрудника: `true` — активен; `false` — заблокирован.
isEnabledUpdatedAt	Type: string<date-time> Дата и время последнего изменения статуса аккаунта сотрудника. Отсутствует если статус никогда не менялся. Example: `2025-01-01T00:00:00Z`
isRobot	Type: boolean Признак служебных сотрудников-ботов: `true` — бот; `false` — человек.
language	Type: string Язык сотрудника. Example: `example`
name	Type: v1UserName ФИО сотрудника. Example `{ "first": "example", "last": "example", "middle": "example" }`
nickname	Type: string Логин сотрудника. Example: `example`
position	Type: string Должность сотрудника. Example: `example`
timezone	Type: string Часовой пояс сотрудника. Example: `example`
updatedAt	Type: string<date-time> Дата и время изменения сотрудника. Example: `2025-01-01T00:00:00Z`

v1UserName

ФИО сотрудника.

Name	Description
first	Type: string Имя сотрудника. Example: `example`
last	Type: string Фамилия сотрудника. Example: `example`
middle	Type: string Отчество сотрудника. Example: `example`

Example

{
  "first": "example",
  "last": "example",
  "middle": "example"
}

v1UserContact

Контакты сотрудника.

Name	Description
alias	Type: boolean Если у сотрудника есть алиас, для него автоматически создается контакт типа `email`: `true` — контакт создан на основе алиаса; `false` — контакт создан вручную.
label	Type: string Произвольная метка контакта. Example: `example`
main	Type: boolean Признак основного контакта: `true` — основной; `false` — альтернативный.
synthetic	Type: boolean Признак автоматически созданного контакта: `true` — контакт создан автоматически; `false` — контакт создан вручную.
type	Type: string Тип контакта. Example: `example`
value	Type: string Значение контакта. Example: `example`

Example

{
  "type": "example",
  "value": "example",
  "main": true,
  "alias": true,
  "synthetic": true,
  "label": "example"
}

400 Bad Request

Некорректный запрос.

Body

application/json

{
  "code": 0,
  "message": "example",
  "details": [
    {
      "@type": "example"
    }
  ]
}

Name	Description
code	Type: integer Код ошибки.
details	Type: protobufAny[] Дополнительные сведения об ошибке. Example `[ { "@type": "example" } ]`
message	Type: string Описание ошибки. Example: `example`

protobufAny

Name

Description

@type

Type: string

Example: example

[additional]

Type: unknown

Example: null

Example

{
  "@type": "example"
}

401 Unauthorized

Пользователь не авторизован.

Body

application/json

{
  "code": 0,
  "message": "example",
  "details": [
    {
      "@type": "example"
    }
  ]
}

Name	Description
code	Type: integer Код ошибки.
details	Type: protobufAny[] Дополнительные сведения об ошибке. Example `[ { "@type": "example" } ]`
message	Type: string Описание ошибки. Example: `example`

403 Forbidden

У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.

Body

application/json

{
  "code": 0,
  "message": "example",
  "details": [
    {
      "@type": "example"
    }
  ]
}

Name	Description
code	Type: integer Код ошибки.
details	Type: protobufAny[] Дополнительные сведения об ошибке. Example `[ { "@type": "example" } ]`
message	Type: string Описание ошибки. Example: `example`

404 Not Found

Запрашиваемый ресурс не найден.

Body

application/json

{
  "code": 0,
  "message": "example",
  "details": [
    {
      "@type": "example"
    }
  ]
}

Name	Description
code	Type: integer Код ошибки.
details	Type: protobufAny[] Дополнительные сведения об ошибке. Example `[ { "@type": "example" } ]`
message	Type: string Описание ошибки. Example: `example`

500 Internal Server Error

Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.

Body

application/json

{
  "code": 0,
  "message": "example",
  "details": [
    {
      "@type": "example"
    }
  ]
}

Name	Description
code	Type: integer Код ошибки.
details	Type: protobufAny[] Дополнительные сведения об ошибке. Example `[ { "@type": "example" } ]`
message	Type: string Описание ошибки. Example: `example`

Была ли статья полезна?

Просмотреть информацию

Посмотреть статус 2FA