Mark signals read in bulk
curl --request POST \
--url https://api-prod.heliyos.ai/v1/platform/signals/bulk-read \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"companyId": "66f1a8c3e4b0a1b2c3d4e5f6"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({companyId: '66f1a8c3e4b0a1b2c3d4e5f6'})
};
fetch('https://api-prod.heliyos.ai/v1/platform/signals/bulk-read', 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/signals/bulk-read"
payload = { "companyId": "66f1a8c3e4b0a1b2c3d4e5f6" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"meta": {
"message": "Signals marked as read"
},
"data": {
"updated": 4,
"failed": [],
"marked_count": 4
}
}{
"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>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}Signals
Mark signals read in bulk
Marks every new signal of one company, one company Scout, or both, read in one update. Send
companyId, scoutId, or both (then only signals matching both are marked).
POST
/
v1
/
platform
/
signals
/
bulk-read
Mark signals read in bulk
curl --request POST \
--url https://api-prod.heliyos.ai/v1/platform/signals/bulk-read \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"companyId": "66f1a8c3e4b0a1b2c3d4e5f6"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({companyId: '66f1a8c3e4b0a1b2c3d4e5f6'})
};
fetch('https://api-prod.heliyos.ai/v1/platform/signals/bulk-read', 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/signals/bulk-read"
payload = { "companyId": "66f1a8c3e4b0a1b2c3d4e5f6" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"meta": {
"message": "Signals marked as read"
},
"data": {
"updated": 4,
"failed": [],
"marked_count": 4
}
}{
"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>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}With an empty body, every unread signal in the workspace is marked read. Send
companyId or
scoutId to limit it.In the Heliyos MCP server:
heliyos_signals_mark_read.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.
Body
application/json
Was this page helpful?

