Modifies an existing user account identified by the login ID. Supports updating the role, email, phone number, and computer scope. Changes take effect immediately.
post /dcapi/users-cloud/{userId}
https://{serverurl}/dcapi/users-cloud/{userId}
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Specifies the request payload format. Set to application/userModification.v1+json to submit the user data in JSON format.
Unique user identifier. To get user id click here. Get User Id
Updated username for the user.
Updated email address for the user.
Updated role identifier for the user. To get available role IDs, use this API. Get Role ID
Computer scope type for the user. 0 = All computers, 1 = Custom scope.
Updated phone number for the user.
curl --request POST \
--url https://appdomains/dcapi/users-cloud/{userId} \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'content-type: application/userModification.v1+json' \
--data '{"computerScopeType":0,"roleID":"9502000000014452","mailID":"john.smith@example.com","userName":"john.smith"}'Update user details including username, email, role, and scope settings.
{
"computerScopeType": 0,
"roleID": "9502000000014452",
"mailID": "john.smith@example.com",
"userName": "john.smith"
}
Application-specific error code indicating the reason for the request failure.
Error message describing the cause of the error.
{}
Error response when the user name is shorter than the minimum required length.
{
"errorCode": "IAM0024",
"errorMsg": "Parameter length of \"userName\" is shorter than minimum requirement."
}
![]()
Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.