Delink
Purpose
To delete the association between modules.
Request URL
To delete a single related record:
https://www.zohoapis.com/crm/v2/{module_api_name}/{record_id}/{related_list_apiname}/{related_record_id}
To delete multiple related records:
https://www.zohoapis.com/crm/v2/{module_api_name}/{record_id}/{related_list_apiname}?ids={comma_separated_related_record_ids}
module_api_name - The API name of the module
record_id - Unique ID of the record
related_list_api_name - The API name of the related list. To get the API name of the related list, see Related Lists Meta Data
related_record_id - Unique ID of the related record.
Request Method
DELETE
Scope
scope=ZohoCRM.modules.all
(or)
scope=ZohoCRM.modules.{module_name}.{operation_type}
Possible module names | Possible operation types |
---|---|
leads, deals, contacts, accounts, products, campaigns, and pricebooks | ALL - Full access to records WRITE - Edit related records DELETE - Delete related records |
You can delete a maximum of 100 related records through an API call, that is, you can specify a maximum of 100 related record IDs in the request URL.
Sample Request
Copiedcurl "https://www.zohoapis.com/crm/v2/Campaigns/3652397000000327001/Contacts?ids=3652397000000925128,3652397000000649013"
-X DELETE
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
CopiedZCRMRecord record = ZCRMRecord.getInstance("Leads", 123456l);//module api name with record id
ZCRMJunctionRecord relatedRecord = ZCRMJunctionRecord.getInstance("Campaigns", 987654l);
APIResponse response = record.deleteRelation(relatedRecord);
String recStatus = response.getStatus(); //check status of the delete relation
Copiedtry{
$parentRecord=ZCRMRecord::getInstance("Products", 410405000001446001);
$junctionRecord=ZCRMJunctionRecord::getInstance("Price_Books",
410405000001404743);
$responseIns=$parentRecord->removeRelation($junctionRecord);
echo "HTTP Code:".$responseIns->getHttpStatusCode();
echo "Message:".$responseIns->getMessage();
echo "Code:".$responseIns->getCode();
echo "Details:".$responseIns->getDetails();
}catch (ZCRMException $e)
{
echo $e->getCode();
echo $e->getMessage();
}
Copied def remove_relation(self):
try:
record = ZCRMRecord.get_instance('Leads', 3719520000000323002) # module API Name, entityId
junction_record = ZCRMJunctionRecord.get_instance("Products",3719520000000450002) # module API Name, entityId
resp = record.remove_relation(junction_record)
print(resp.status_code)
print(resp.code)
print(resp.details)
print(resp.message)
print(resp.status)
except ZCRMException as ex:
print(ex.status_code)
print(ex.error_message)
print(ex.error_code)
print(ex.error_details)
print(ex.error_content)
CopiedZCRMRecord recordIns = ZCRMRecord.GetInstance("Leads", 3372164000001494008);//module api name with record id
ZCRMJunctionRecord relatedRecord = ZCRMJunctionRecord.GetInstance("Campaigns", 3372164000000266194); //RelatedList api name with RelatedList record id
APIResponse response = recordIns.DeleteRelation(relatedRecord);
String recStatus = response.Status; //check status of the delete relation
Sample Response
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"id": "3652397000000925128"
},
"message": "relation removed",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"id": "3652397000000649013"
},
"message": "relation removed",
"status": "success"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}
Sample Response
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"id": "3652397000000925128"
},
"message": "relation removed",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"id": "3652397000000649013"
},
"message": "relation removed",
"status": "success"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}
Sample Response
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"id": "3652397000000925128"
},
"message": "relation removed",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"id": "3652397000000649013"
},
"message": "relation removed",
"status": "success"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}
Sample Response
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"id": "3652397000000925128"
},
"message": "relation removed",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"id": "3652397000000649013"
},
"message": "relation removed",
"status": "success"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}
Copied{
"data": [
{
"message": "relation removed",
"details": {
"id": "4000000039247"
},
"status": "success",
"code": "SUCCESS"
}
]
}