Update a user

PUT /api/2.0/people/{userid}

Request

Updates the data for the selected portal user with the first name, last name, email address, and/or optional parameters specified in the request.

Authorization

An API key is a token that you provide when making API calls. Include the token in a header parameter called Authorization.

Example: Authorization: 864FE52C-1C1C-469F-9308-51DAFEFE7436.

Headers

Acceptenum of string

Can be one of: application/json.

Content-Typeenum of string

Can be one of: application/json.

Path

useridstring

User ID

Body

isVisitorboolean

Specifies if this is a guest (true) or user (false)

firstnamestring

New user first name

lastnamestring

New user last name

commentstring

New user comment

departmentarray of string

New user department

titlestring

New user title

locationstring

New user location

sexstring

New user sex (male or female)

birthdaystring

New user birthday

worksfromstring

New user registration date. If it is not specified, then the current date will be set

contactsarray of object

New contact list

Typestring
Valuestring
filesstring

New avatar photo URL

disablearray of boolean

Specifies whether to disable a user on the portal or not

leadarray of string

User lead

Examples

PUT /api/2.0/people/%7Buserid%7D HTTP/1.1
Accept: application/json
Content-Length: 117
Content-Type: application/json
Host: example.com

{
  "contacts": [
    {
      "value": {
        "Type": "GTalk",
        "Value": "my@gmail.com"
      }
    }
  ]
}
curl --request PUT \
  --url https://example.com/api/2.0/people/%7Buserid%7D \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "contacts": [
    {
      "value": {
        "Type": "GTalk",
        "Value": "my@gmail.com"
      }
    }
  ]
}'

Responses

200

Updated user

FirstNamestring
LastNamestring
UserNamestring
Emailstring
Birthdaystring
Sexstring
Statusenum of integerformat: int32

[1 - Active, 2 - Terminated, 4 - LeaveOfAbsence, 5 - Default, 7 - All]

Can be one of: Active, Terminated, LeaveOfAbsence, Default, All.

ActivationStatusenum of integerformat: int32

[0 - NotActivated, 1 - Activated, 2 - Pending, 4 - AutoGenerated]

Can be one of: NotActivated, Activated, Pending, AutoGenerated.

Terminatedstring
Departmentstring
WorkFromstring
Groupsarray of object
Namestring
Idstringformat: uuid
Managerstring
Locationstring
Notesstring
Leadstringformat: uuid
AvatarMediumstring
Avatarstring
IsAdminboolean
IsLDAPboolean
ListAdminModulesarray of string
IsOwnerboolean
IsVisitorboolean
CultureNamestring
IsSSOboolean
QuotaLimitintegerformat: int64
UsedSpaceintegerformat: int64
DocsSpaceintegerformat: int64
MailSpaceintegerformat: int64
TalkSpaceintegerformat: int64
Idstringformat: uuid
DisplayNamestring
Titlestring
AvatarSmallstring
ProfileUrlstring

401

Unauthorized

Get Help

  • If you have any questions about ONLYOFFICE Workspace, try the FAQ section first.
  • You can request a feature or report a bug by posting an issue on GitHub.
  • You can also ask our developers on ONLYOFFICE forum (registration required).