Manage security agents and their configuration programmatically
Retrieve all agents in your organization.
GET /v1/agents
Response:
{
"agents": [
{
"id": "agent_123",
"name": "Web Server Monitor",
"status": "active",
"type": "network",
"last_seen": "2025-01-08T10:30:00Z"
}
]
}
Retrieve detailed information about a specific agent.
GET /v1/agents/:id
Response:
{
"id": "agent_123",
"name": "Web Server Monitor",
"status": "active",
"type": "network",
"config": {
"scan_interval": 60,
"alert_threshold": "high"
},
"metrics": {
"threats_detected": 42,
"uptime": 99.9
}
}
Modify agent settings and policies.
PATCH /v1/agents/:id
Content-Type: application/json
{
"config": {
"scan_interval": 30,
"alert_threshold": "medium"
}
}
DELETE /v1/agents/:id