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 |
Permissions
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. 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
Sample Response
Limitations
- 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.