Mark a signal read
curl --request POST \
--url https://api-prod.heliyos.ai/v1/platform/signals/{id}/read \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/signals/{id}/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/{id}/read"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"meta": {
"message": "Signal marked as read"
},
"data": {
"success": true,
"signal": {
"_id": "6735a9d1e2f3a4b5c6d7e8f9",
"organizationId": "66a0f1e2d3c4b5a697887766",
"baseSchemaObjectId": "66f1a8c3e4b0a1b2c3d4e5f6",
"scout_name": "Funding, M&A, or financial news",
"summary": "Northwind Traders raised a 40 million dollar Series C to expand into Southeast Asia.",
"detected_date": "2026-11-03T06:00:00.000Z",
"status": "read"
}
}
}{
"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 a signal read
Sets one signal’s status to read. Marking a read signal again changes nothing; an archived signal
becomes read. To mark many at once, use POST /v1/platform/signals/bulk-read.
POST
/
v1
/
platform
/
signals
/
{id}
/
read
Mark a signal read
curl --request POST \
--url https://api-prod.heliyos.ai/v1/platform/signals/{id}/read \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/signals/{id}/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/{id}/read"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"meta": {
"message": "Signal marked as read"
},
"data": {
"success": true,
"signal": {
"_id": "6735a9d1e2f3a4b5c6d7e8f9",
"organizationId": "66a0f1e2d3c4b5a697887766",
"baseSchemaObjectId": "66f1a8c3e4b0a1b2c3d4e5f6",
"scout_name": "Funding, M&A, or financial news",
"summary": "Northwind Traders raised a 40 million dollar Series C to expand into Southeast Asia.",
"detected_date": "2026-11-03T06:00:00.000Z",
"status": "read"
}
}
}{
"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>"
}
}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.
Path Parameters
The signal's id.
Pattern:
^[0-9a-fA-F]{24}$Was this page helpful?

