Update Record Locking Information
Purpose
Use the Update Record Locking Infromation API to modify locking information of locked records in different modules.
Request Details
Request URL
{api-domain}/crm/{version}/{module_API_name}/{record_id}/Locking_Information__s/{record_locking_id}
Header
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Scope
scope=ZohoCRM.modules.lockinginformation.Update
(and)
scope=ZohoCRM.modules.All (or) scope=ZohoCRM.modules.{module_name}.{operation_type}
Possible module names
leads, accounts, contacts, deals, tasks, cases, solutions, vendors, pricebooks, quotes, salesorders, purchaseorders, invoices and custom
Possible operation types
All - Full access to the record
Update - Update records of the module
Sample Request
Copiedcurl "https://www.zohoapis.com/crm/v5/Leads/5843104000000425565/Locking_Information__s/5843104000000804005"
-X PUT
-d "@updaterecordlock.json"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
Input JSON Keys
- Locked_Reason__s string,mandatory
Specify the reason the records are locked.
Sample Input
Copied{
"data": [
{
"Locked_Reason__s": "deal info updated"
}
]
}
Possible Errors
- INVALID_MODULEHTTP 400
The module name given seems to be invalid.
Resolution: Specify a valid module API name. - NOT_ALLOWEDHTTP 403
Record is already locked.
Resolution: You can lock a record that is not already locked. - INVALID_REQUEST_METHODHTTP 403
The http request method type is not a valid one.
Resolution: You have specified an invalid HTTP method to access the API URL. Specify a valid request method. Refer to endpoints section above. - NO_PERMISSIONHTTP 403
Permission denied to customize record lock configurations. The user does not have permission.
Resolution: Contact your system administrator. - INTERNAL_ERRORHTTP 500
Internal Server Error.
Resolution:Unexpected and unhandled exception in the server. Contact support team.
Sample Response
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"id": "5843104000000804005"
},
"message": "relation updated",
"status": "success"
}
]
}