Update User's Departments

Updates information of Departments that a User belongs to, and Job Title information related to the Department.
Method PUT
URL https://{subdomain}.kintone.com/v1/userOrganizations.json
Authentication Password Authentication
Content-Type application/json


Only Administrators can use this API.

Request Parameters

Parameter Value Required Description
code String Yes The User's code (log-in name).
The maximum limit is 128 characters.
Values consisting of only whitespaces or null are not allowed.
organizations Array of Objects Yes

An array of organizations objects containing data of Departments the users will be a member of.
The maximum limit is 100 objects.

Any existing Department that is not set for this parameter will result in the user being removed from that department.

If the array is empty, the user will not be a member of any Department.

organizations[].orgCode String Conditional The Department Code of the Department to add the user to.
The maximum limit is 128 characters.

Required when specifying a Job Title.
organizations[].titleCode String   The code of the Job Title.
The maximum limit is 128 characters.

Sample Request

JavaScript (using Kintone REST API Request)

curl Sample

Sample Response


  • Deadlocks may occur if the following are operated simultaneously:
    • A System Administrator imports a CSV file through the GUI to update users in the domain.
    • The Update User's Departments API is used.
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!