get https://api.picussecurity.com/v1/integrations/agents
Integration Agent List; Integration Agent ID, Integration Agent Name, Created At, Updated At, Status (Alive | Dead), Is Installed, Is Token Expired
About
Each integration should be connected with an integration agent. The integration agent connects to the SIEM/EDR and makes the detection analytics.
Integration Agents endpoint returns the agent name, id, status, agent installation information and the token expiration information.
Return Definitions
- status = alive means that the agent is alive and the agent is sending health check signals
- status = dead means that agent is not alive and the health check signals will not be received for a while
Example
{
"integration_agents": [
{
"id": 1,
"created_at": 1643367463546,
"updated_at": 1655152142976,
"name": "Picus Agent",
"status": "Alive",
"installed": true,
"token_expired": false
},
{
"id": 2,
"created_at": 1653995219617,
"updated_at": 1653995219617,
"name": "Picus Agent 2",
"status": "Dead",
"installed": false,
"token_expired": true
}
]
}