Argus
API Reference

REST API

Full Argus REST API reference.

Services

List Services

GET /api/v1/services

Returns all services monitored by your organization.

{
  "services": [
    {
      "id": "svc_123",
      "name": "web-server-01",
      "status": "healthy",
      "last_seen": "2024-01-15T14:30:00Z",
      "metrics": {
        "cpu_percent": 42.5,
        "memory_percent": 68.2
      }
    }
  ]
}

Alerts

List Alerts

GET /api/v1/alerts

Query parameters:

  • statusactive, resolved, all (default: active)
  • severitycritical, warning, info
  • limit — Results per page (default: 50)
  • offset — Pagination offset

List Alert Rules

GET /api/v1/alerts/rules

Create Alert Rule

POST /api/v1/alerts/rules
{
  "name": "High CPU Alert",
  "metric": "cpu_percent",
  "condition": "greater_than",
  "threshold": 90,
  "duration_minutes": 5,
  "severity": "critical",
  "channels": ["slack", "email"]
}

Investigations

List Investigations

GET /api/v1/investigations

Returns AI investigations with their status and findings.

Get Investigation

GET /api/v1/investigations/:id

Returns full investigation details including the AI analysis, timeline, and recommendations.

Pagination

All list endpoints support pagination:

  • limit — Number of results (default: 50, max: 100)
  • offset — Starting offset
GET /api/v1/services?limit=10&offset=20

On this page