deleteRecord (Client API reference)

Deletes a table record.

Syntax

Xrm.WebApi.deleteRecord(entityLogicalName, id).then(successCallback, errorCallback);

Parameters

Name	Type	Required	Description
entityLogicalName	String	Yes	The table logical name of the record you want to delete. For example: "account".
id	String	Yes	GUID of the table record you want to delete.
successCallback	Function	No	A function to call when a record is deleted. An object with the following properties will be passed to identify the deleted record: entityType: String. The table type of the record. id: String. GUID of the record. name: String. Name of the record.
errorCallback	Function	No	A function to call when the operation fails.

Return Value

On success, returns a promise object containing the values specified earlier in the description of the successCallback parameter.

Examples

These examples use some of the same request objects as demonstrated in Update and delete tables using the Web API to define the data object for updating an entity record.

Deletes an account with record ID = 5531d753-95af-e711-a94e-000d3a11e605.

Xrm.WebApi.deleteRecord("account", "5531d753-95af-e711-a94e-000d3a11e605").then(
    function success(result) {
        console.log("Account deleted");
        // perform operations on record deletion
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Related topics

Xrm.WebApi