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
- Accept
enum of string
Can be one of:
application/json
.- Content-Type
enum of string
Can be one of:
application/json
.
Path
- userid
string
User ID
Body
- isVisitor
boolean
Specifies if this is a guest (true) or user (false)
- firstname
string
New user first name
- lastname
string
New user last name
- comment
string
New user comment
- department
array of string
New user department
- title
string
New user title
- location
string
New user location
- sex
string
New user sex (male or female)
- birthday
string
New user birthday
- worksfrom
string
New user registration date. If it is not specified, then the current date will be set
- contacts
array of object
New contact list
- Type
string
- Value
string
- files
string
New avatar photo URL
- disable
array of boolean
Specifies whether to disable a user on the portal or not
- lead
array 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
- FirstName
string
- LastName
string
- UserName
string
- Email
string
- Birthday
string
- Sex
string
- Status
enum of integer
int32 [1 - Active, 2 - Terminated, 4 - LeaveOfAbsence, 5 - Default, 7 - All]
Can be one of:
Active
,Terminated
,LeaveOfAbsence
,Default
,All
.- ActivationStatus
enum of integer
int32 [0 - NotActivated, 1 - Activated, 2 - Pending, 4 - AutoGenerated]
Can be one of:
NotActivated
,Activated
,Pending
,AutoGenerated
.- Terminated
string
- Department
string
- WorkFrom
string
- Groups
array of object
- Name
string
- Id
string
uuid - Manager
string
- Location
string
- Notes
string
- Lead
string
uuid - AvatarMedium
string
- Avatar
string
- IsAdmin
boolean
- IsLDAP
boolean
- ListAdminModules
array of string
- IsOwner
boolean
- IsVisitor
boolean
- CultureName
string
- IsSSO
boolean
- QuotaLimit
integer
int64 - UsedSpace
integer
int64 - DocsSpace
integer
int64 - MailSpace
integer
int64 - TalkSpace
integer
int64 - Id
string
uuid - DisplayName
string
- Title
string
- AvatarSmall
string
- ProfileUrl
string
401
Unauthorized