Remove Entities from Contacts Table
Remove specific contact IDs from a table.
Billing: Free.
curl --request DELETE \
--url https://api.lusha.com/v3/contacts/tables/{table_id}/entities \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"entityIds": [
"10042851",
"10042852"
],
"owner": {
"email": "user@example.com"
}
}
'import requests
url = "https://api.lusha.com/v3/contacts/tables/{table_id}/entities"
payload = {
"entityIds": ["10042851", "10042852"],
"owner": { "email": "user@example.com" }
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({entityIds: ['10042851', '10042852'], owner: {email: 'user@example.com'}})
};
fetch('https://api.lusha.com/v3/contacts/tables/{table_id}/entities', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.delete("https://api.lusha.com/v3/contacts/tables/{table_id}/entities")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"entityIds\": [\n \"10042851\",\n \"10042852\"\n ],\n \"owner\": {\n \"email\": \"user@example.com\"\n }\n}")
.asString();package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/contacts/tables/{table_id}/entities"
payload := strings.NewReader("{\n \"entityIds\": [\n \"10042851\",\n \"10042852\"\n ],\n \"owner\": {\n \"email\": \"user@example.com\"\n }\n}")
req, _ := http.NewRequest("DELETE", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}Authorizations
Your Lusha API key. You can find this in your Lusha dashboard under API settings.
Include this key in the api_key header for all requests.
Path Parameters
The table's ID.
Body
Accepts either the encrypted token (v{N}.…, as returned by Get Entities) or the legacy numeric ID. Unresolved IDs are echoed back in invalidIds in the exact form you sent them.
["10042851", "10042852"]
Identifies the user acting on the table, and resolves to a user on your account. Required on every table-route call when authenticating with an API key (there is no signed-in user) - omitting it returns 400. Optional for OAuth/token callers, since the caller is already identified by the token; still accepted if you want to act on behalf of another owner.
Show child attributes
Show child attributes
Was this page helpful?
curl --request DELETE \
--url https://api.lusha.com/v3/contacts/tables/{table_id}/entities \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"entityIds": [
"10042851",
"10042852"
],
"owner": {
"email": "user@example.com"
}
}
'import requests
url = "https://api.lusha.com/v3/contacts/tables/{table_id}/entities"
payload = {
"entityIds": ["10042851", "10042852"],
"owner": { "email": "user@example.com" }
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({entityIds: ['10042851', '10042852'], owner: {email: 'user@example.com'}})
};
fetch('https://api.lusha.com/v3/contacts/tables/{table_id}/entities', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.delete("https://api.lusha.com/v3/contacts/tables/{table_id}/entities")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"entityIds\": [\n \"10042851\",\n \"10042852\"\n ],\n \"owner\": {\n \"email\": \"user@example.com\"\n }\n}")
.asString();package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/contacts/tables/{table_id}/entities"
payload := strings.NewReader("{\n \"entityIds\": [\n \"10042851\",\n \"10042852\"\n ],\n \"owner\": {\n \"email\": \"user@example.com\"\n }\n}")
req, _ := http.NewRequest("DELETE", url, payload)
req.Header.Add("api_key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}