Delete profile list recipients based on RIID
Use this interface to delete a profile list member by specifying the RIID for that member.
Service URL:
/rest/api/v1.3/lists/{listName}/members/{riid}
Request Method:
DELETE
Request Header:
Authorization=<AUTH_TOKEN>
Request Body:
None
Sample Response in case of success:
REQUEST NOTES:
- The response will always contain only RIID_ in the fieldNames attribute and the corresponding RIID_ values for the records in the records attribute in case the deletion of that record is successful.
- In case delete failed for a record for some reason, the RIID_ of the record is not present in the response. Instead, an error message starting with DELETEFAILED: is returned. Client developers can look for the string DELETEFAILED: in the response for a particular row to determine whether that recipient was deleted successfully or not.
- Other attributes in the response (mapTemplateName, mergeRule) will have default values (null/false).
{{
"recordData": {
"fieldNames": ["RIID_"],
"records": [["1561"]],
"mapTemplateName": null
},
"mergeRule": {
"textValue": null,
"matchColumnName3": null,
"matchColumnName1": null,
"matchColumnName2": null,
"rejectRecordIfChannelEmpty": null,
"defaultPermissionStatus": null,
"updateOnMatch": null,
"matchOperator": null,
"optinValue": null,
"optoutValue": null,
"htmlValue": null,
"insertOnNoMatch": false
},
"links": [
{
"rel": "self",
"href": "/rest/api/v1.3/lists/DemoProfileList/members/1561",
"method": "DELETE"
},
{
"rel": "mergeListRecipients",
"href": "/rest/api/v1.3/lists/DemoProfileList/members",
"method": "POST"
},
{
"rel": "retrieveListRecipientsRIID",
"href": "/rest/api/v1.3/lists/DemoProfileList/members/<riid>",
"method": "GET"
}
]
}
Sample Response in case recipient is not found:
{
"type": "",
"title": "No recipient found",
"errorCode": "NO_RECIPIENT_FOUND",
"detail": "Record not Found in the List.",
"errorDetails": []
}
Sample Response in case of failure:
{
"recordData": {
"fieldNames": ["RIID_"],
"records": [["DELETEFAILED: ERROR: The value abdce is not valid for an integer field"]],
"mapTemplateName": null
},
"mergeRule": {
"textValue": null,
"matchColumnName3": null,
"matchColumnName1": null,
"matchColumnName2": null,
"rejectRecordIfChannelEmpty": null,
"defaultPermissionStatus": null,
"updateOnMatch": null,
"matchOperator": null,
"optinValue": null,
"optoutValue": null,
"htmlValue": null,
"insertOnNoMatch": false
},
"links": [
{
"rel": "self",
"href": "/rest/api/v1.3/lists/DemoProfileList/members/abcde",
"method": "DELETE"
},
{
"rel": "mergeListRecipients",
"href": "/rest/api/v1.3/lists/DemoProfileList/members",
"method": "POST"
},
{
"rel": "retrieveListRecipientsRIID",
"href": "/rest/api/v1.3/lists/DemoProfileList/members/<riid>",
"method": "GET"
}
]
}