API Reference

Devloom REST API v1. Base URL: https://api.devloomx.com/v1

Authentication

All requests require a bearer token in the Authorization header. Generate tokens at Settings → API Tokens.

Authorization: Bearer <your-api-token>

Rate limits: 600 req/min (Starter), 3,000 req/min (Pro), 12,000 req/min (Team). Exceeded requests receive 429 Too Many Requests with a Retry-After header.

Services

A service represents a logical unit of your infrastructure (a microservice, queue, database, etc.).

GET /v1/services

List all services in your workspace.

{
  "services": [
    {
      "id": "svc_abc123",
      "name": "payment-api",
      "status": "healthy",
      "last_seen": "2026-06-27T04:12:00Z",
      "series_count": 4280
    }
  ],
  "total": 1
}

GET /v1/services/{service_id}

Retrieve a single service by ID.

Incidents

Incidents are automatically created when Devloom detects anomalies above your configured thresholds.

GET /v1/incidents

List incidents. Optional query params: status (open|resolved), service_id, from / to (RFC 3339).

{
  "incidents": [
    {
      "id": "inc_xyz789",
      "title": "Payment API p99 latency anomaly",
      "status": "open",
      "severity": "high",
      "service_id": "svc_abc123",
      "created_at": "2026-06-27T03:47:22Z",
      "rca_id": "rca_def456"
    }
  ]
}

POST /v1/incidents/{incident_id}

Update an incident. Supported fields: status (resolved), note.

Root cause analysis

GET /v1/rca/{rca_id}

Retrieve root cause analysis results for an incident.

{
  "id": "rca_def456",
  "incident_id": "inc_xyz789",
  "confidence": 0.91,
  "root_cause": {
    "service": "postgres-primary",
    "signal": "pg_stat_activity.waiting",
    "description": "Connection pool saturation: 98% utilized, avg wait 2.1s"
  },
  "blast_radius": ["payment-api", "order-service"],
  "remediation_id": "rem_ghi012"
}

POST /v1/rca/trigger

Manually trigger RCA for a service and time window. Useful for post-mortems on past incidents not auto-detected.

{
  "service_id": "svc_abc123",
  "from": "2026-06-26T22:00:00Z",
  "to": "2026-06-26T22:30:00Z"
}

Remediation

GET /v1/remediations/{remediation_id}

Fetch the remediation diff generated for a root cause analysis result.

{
  "id": "rem_ghi012",
  "rca_id": "rca_def456",
  "status": "pending",
  "diff": "--- a/postgres.conf\n+++ b/postgres.conf\n@@ -12,1 +12,1 @@\n-max_connections = 100\n+max_connections = 200",
  "expected_impact": "Resolves connection pool saturation. Estimated MTTR reduction: 82%."
}

POST /v1/remediations/{remediation_id}/apply

Trigger one-click apply via your connected CI/CD pipeline. Requires a pipeline integration configured in Settings.

Annotations

Post deployment events, config changes, or custom signals as annotations. Devloom uses these as temporal markers when building causal models.

POST /v1/annotations

Create a new annotation.

{
  "type": "deployment",
  "service_id": "svc_abc123",
  "timestamp": "2026-06-27T03:45:00Z",
  "message": "Deploy v2.4.1 — increases DB pool size",
  "meta": {
    "commit": "a1b2c3d",
    "author": "[email protected]"
  }
}

← Quickstart