Delete records
curl --request POST \
--url https://api-prod.heliyos.ai/v1/platform/base-schemas/{id}/records/bulk-delete \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"objectIds": [
"6721c3d5e6f7a8b9c0d1e2f3",
"6721c3d5e6f7a8b9c0d1e2f5"
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({objectIds: ['6721c3d5e6f7a8b9c0d1e2f3', '6721c3d5e6f7a8b9c0d1e2f5']})
};
fetch('https://api-prod.heliyos.ai/v1/platform/base-schemas/{id}/records/bulk-delete', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/platform/base-schemas/{id}/records/bulk-delete"
payload = { "objectIds": ["6721c3d5e6f7a8b9c0d1e2f3", "6721c3d5e6f7a8b9c0d1e2f5"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"meta": {
"message": "Objects deleted successfully"
},
"data": {}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}Records
Delete records
Permanently deletes up to 1000 records of one object in a single call.
Ids that are not records of this object are ignored. The response does not say how many records
were deleted. Deleting removes the records from every other record’s relationships. Notes and
tasks linked to them are kept. Each deleted record fires the <type>.deleted event, and records
synced to HubSpot are deleted there too.
POST
/
v1
/
platform
/
base-schemas
/
{id}
/
records
/
bulk-delete
Delete records
curl --request POST \
--url https://api-prod.heliyos.ai/v1/platform/base-schemas/{id}/records/bulk-delete \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"objectIds": [
"6721c3d5e6f7a8b9c0d1e2f3",
"6721c3d5e6f7a8b9c0d1e2f5"
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({objectIds: ['6721c3d5e6f7a8b9c0d1e2f3', '6721c3d5e6f7a8b9c0d1e2f5']})
};
fetch('https://api-prod.heliyos.ai/v1/platform/base-schemas/{id}/records/bulk-delete', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/platform/base-schemas/{id}/records/bulk-delete"
payload = { "objectIds": ["6721c3d5e6f7a8b9c0d1e2f3", "6721c3d5e6f7a8b9c0d1e2f5"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"meta": {
"message": "Objects deleted successfully"
},
"data": {}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}Deleting records cannot be undone. Linked records lose their links to the deleted records.
In the Heliyos MCP server:
heliyos_records_delete.Authorizations
A workspace API key, sent as Authorization: Bearer heliyos_.... Create one in Heliyos under Settings → API keys. A key acts as a workspace admin in the one workspace it was created in.
Path Parameters
The id of the object the records belong to.
Pattern:
^[0-9a-fA-F]{24}$Body
application/json
Ids of the records to delete, 1 to 1000.
Required array length:
1 - 1000 elementsA 24-character hexadecimal id.
Pattern:
^[0-9a-fA-F]{24}$Was this page helpful?

