Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

Use this method to update properties of an existing user. It is also used to disable a login, to change the password or to activate a login.

URL

(POST) companies/{companyid}/persons

PARAMETERS

token

The token obtained on connection

Required

companyid

The company id of the person to modify

Required

data

A json containing the person information (see below)

Required


JSON format of "data" parameter

PersonIdThe person id of the person to updateRequired
LastNameThe last name of the personOptional
FirstNameThe first name of the personOptional
EmailThe email address of the person. This must be a valid email address or the API will return an error.Optional
LoginThe login to connect. Use for example "John.Hollow" or "mylogin123". The minimum length of logins is 8 characters.Optional
PasswordThe password to connect. The password must comply with the password policy settings (see "Settings" > "Advanced security" in Wordbee Translator.Optional
UserProfileIdThe profile id of the person. See API call to enumerate profiles. Note that you cannot create a person with the Administrator profile and that you cannot delete the Administrator.Optional
IsActiveActivate or deactivate account. An inactive account cannot login. Boolean value. To activate a person you need to specify login, password and profile id as well.Default value if not set: falseOptional
PersonCodeThe person code. Default value: If not set, then preset with the first letter of the first name and the first letter of the last name.Optional
TitleThe person titleOptional
RoleThe person roleOptional
PhoneThe person phone numberOptional
PhoneMobile The person mobile phone numberOptional
CommentsInternal comments on personOptional
LabelsSet a label: "labels": [ { "id": 10, "value": 1 }, … ] Clear a label: "labels": [ { "id": 10, "value": null }, … ] See chapter REF _Ref362347538 \r \h 12.5 to get the list of labels.Optional

RESULTS

No result. In case of invalid parameters an HTTP error code is returned.





  • No labels