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
    }
  ]
}