Guides
API reference
MCP server
ChangelogDelete a field
curl --request DELETE \
--url https://api-prod.heliyos.ai/v1/platform/base-schemas/{id}/fields/{fieldId} \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/base-schemas/{id}/fields/{fieldId}', 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}/fields/{fieldId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text){
"meta": {
"message": "Schema attribute 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>"
}
}Schemas
Delete a field
Deletes one field of an object (base schema) and removes its value from every record, permanently.
The API does not protect any field: built-in fields such as a company’s company_name, the
field a board’s lanes come from, and relationship fields are deleted like any other. Deleting a
relationship field leaves the matching field on the other object unchanged.
DELETE
/
v1
/
platform
/
base-schemas
/
{id}
/
fields
/
{fieldId}
Delete a field
curl --request DELETE \
--url https://api-prod.heliyos.ai/v1/platform/base-schemas/{id}/fields/{fieldId} \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/base-schemas/{id}/fields/{fieldId}', 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}/fields/{fieldId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text){
"meta": {
"message": "Schema attribute 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>"
}
}This removes the field and its value on every record of the object. It cannot be undone.
In the Heliyos MCP server:
heliyos_fields_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 object's id.
Pattern:
^[0-9a-fA-F]{24}$The field's id, from Get an object.
Pattern:
^[0-9a-fA-F]{24}$Was this page helpful?