Update Users

Updates users of a kintone environment.
Method PUT
URL https://{subdomain}.kintone.com/v1/users.json
Authentication Password Authentication
Content-Type application/json

Permissions

Only Administrators can use this API.

Request Parameters

Parameter Value Required Description
code String Yes

The User Code (log-in name).
The maximum limit is 128 characters.
Values consisting of only whitespaces or null are not allowed. 

valid Boolean   The Status of the user.
State true for active users, and false for inactive users.
password String  

The password.
The maximum limit is 128 characters.
Whitespaces are not allowed.

name String  

The display name.
The maximum limit is 128 characters.
Values consisting of only whitespaces or null are not allowed.

surName String  

The Surname.
The maximum limit is 128 characters.

givenName String  

The Given Name.
The maximum limit is 128 characters.

surNameReading String  

The Phonetic Surname.
The maximum limit is 128 characters.
This setting is not displayed when editing user information on the "Departments & Users" page for kintone.com domains.

givenNameReading String  

The Phonetic Given Name.
The maximum limit is 128 characters.
This setting is not displayed when editing user information on the "Departments & Users" page for kintone.com domains.

localName String  

The Localizled Name.
The maximum limit is 128 characters.
This setting is not displayed when editing user information on the "Departments & Users" page for kintone.com domains.

localNameLocale String  

The Language for the Localized Name.
The maximum limit is 128 characters.
This setting is not displayed when editing user information on the "Departments & Users" page for kintone.com domains.

timezone String  

The user's timezone.
An error will occur if left blank.
The maximum limit is 256 characters.

locale String  

The language settings.
The maximum limit is 256 characters.

description String  

The description of the user, displayed on the "About me" section of the profile.
The maximum limit is 1000 characters.

phone String  

The Phone number.
The maximum limit is 100 characters.

mobilePhone String  

The Mobile phone number.
The maximum limit is 100 characters.

extensionNumber String  

The Extension number.
The maximum limit is 100 characters.

email String  

The E-mail address.
The maximum limit is 256 characters.

callto String  

The Skype name.
Limitations are based on limitations of Skype names.

url String  

URL
The maximum limit is 256 characters.

employeeNumber String  

The Employee ID.
The maximum limit is 100 characters.

birthDate Date   The Birthday.
joinDate Date   The Hire Date.
sortOrder Number  

The priority of the user in lists of users. Users are sorted in the list in ascending order based on this number.
Numbers from 0 to 99999999 can be used.

customItemValues customItemValue Array   A list of pairs of Custom Item codes and Custom Item values for Custom Fields.

Sample Request

JavaScript (using kintone REST API Request)

XMLHttpRequest

Response Parameters

An empty JSON object will be returned.

Sample Response

Was this article helpful?
0 out of 0 found this helpful
Do you have any questions or issues related to this article?
Please share your views with us in the Community forums!