Unwatch a company
curl --request DELETE \
--url https://api-prod.heliyos.ai/v1/platform/companies/{id}/watch \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/companies/{id}/watch', 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/companies/{id}/watch"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text){
"meta": {
"message": "Company unwatched."
},
"data": {
"_id": "66f1a8c3e4b0a1b2c3d4e5f6",
"organizationId": "66a0f1e2d3c4b5a697887766",
"baseSchemaId": "66a0f1e2d3c4b5a697880001",
"objectType": "company",
"data": {
"company_name": "Northwind Traders",
"website": "https://northwind.example.com",
"account_status": "customer",
"engagement_status": "active"
},
"isAgentAssigned": false,
"agentAssignmentStatus": null,
"metadata": {
"created": {
"at": "2026-09-12T10:00:00.000Z",
"by": "66a0f1e2d3c4b5a697881111"
},
"updated": {
"at": "2026-11-05T14:10:00.000Z",
"by": "66a0f1e2d3c4b5a697881111"
}
}
}
}{
"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>"
}
}Watchlist
Unwatch a company
Removes a company from the watchlist and frees its Watcher. Its company Scouts are stopped and deleted, together with the signals they found, and the workers stop monitoring it. Its emails, meetings, tasks and notes stay, so watching it again picks the history back up.
Records that were marked watched along with the company (its people and deals) stay marked. Unwatching a company that is not watched frees no Watcher, but still removes any Scouts left on it.
DELETE
/
v1
/
platform
/
companies
/
{id}
/
watch
Unwatch a company
curl --request DELETE \
--url https://api-prod.heliyos.ai/v1/platform/companies/{id}/watch \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/companies/{id}/watch', 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/companies/{id}/watch"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text){
"meta": {
"message": "Company unwatched."
},
"data": {
"_id": "66f1a8c3e4b0a1b2c3d4e5f6",
"organizationId": "66a0f1e2d3c4b5a697887766",
"baseSchemaId": "66a0f1e2d3c4b5a697880001",
"objectType": "company",
"data": {
"company_name": "Northwind Traders",
"website": "https://northwind.example.com",
"account_status": "customer",
"engagement_status": "active"
},
"isAgentAssigned": false,
"agentAssignmentStatus": null,
"metadata": {
"created": {
"at": "2026-09-12T10:00:00.000Z",
"by": "66a0f1e2d3c4b5a697881111"
},
"updated": {
"at": "2026-11-05T14:10:00.000Z",
"by": "66a0f1e2d3c4b5a697881111"
}
}
}
}{
"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>"
}
}The company’s Scouts and their signals are deleted. Watching the company again starts new Scouts.
In the Heliyos MCP server:
heliyos_companies_unwatch.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 company record's id.
Pattern:
^[0-9a-fA-F]{24}$Was this page helpful?

