Base URL: https://api.geteridian.com/v1. Keys: eridian_sk_. Models: gpt, gemini, auto.
Scopes
| Scope | Access |
|---|
ops:read | GET incidents, services, queries, post-mortems |
ops:write | Open incidents, query logs, draft post-mortems, manage connectors |
Incidents
| Method | Path |
|---|
POST | /v1/ops/incidents |
GET | /v1/ops/incidents |
GET | /v1/ops/incidents/{id} |
POST | /v1/ops/incidents/{id}/summarize |
POST | /v1/ops/incidents/{id}/events |
GET | /v1/ops/incidents/{id}/events |
POST | /v1/ops/incidents/{id}/close |
On-call and logs
| Method | Path |
|---|
GET | /v1/ops/on-call/shift |
POST | /v1/ops/on-call/query |
POST | /v1/ops/on-call/handoff |
POST | /v1/ops/logs/query |
GET | /v1/ops/logs/query/{id} |
Post-mortems, runbooks, services, connectors
| Method | Path |
|---|
POST | /v1/ops/postmortems |
POST | /v1/ops/postmortems/{id}/publish |
POST | /v1/ops/runbooks/generate |
POST | /v1/ops/services |
GET | /v1/ops/services |
PUT | /v1/ops/services/{id}/slos |
GET | /v1/ops/services/{id}/error-budget |
POST | /v1/ops/services/{id}/sla-credits |
POST | /v1/ops/connectors |
GET | /v1/ops/connectors/{id}/health |
POST | /v1/ops/connectors/{id}/disable |
Objects
object | Id prefix |
|---|
eridian.ops.incident | inc_ |
eridian.ops.incident.summary | ism_ |
eridian.ops.log_query | logq_ |
eridian.ops.oncall.query | ocq_ |
eridian.ops.postmortem | pm_ |
eridian.ops.service | svc_ |
Errors
| HTTP | Code | When |
|---|
| 409 | incident_not_open | Close/summarize conflict |
| 409 | query_window_too_large | Log window over cap |
| 403 | connector_disabled | Scan against disabled connector |
| 404 | service_not_found | Unknown service_id |
Python
from eridian import Eridian
client = Eridian(api_key="eridian_sk_...", project_id="prj_ops_001")
incident = client.ops.incidents.create(
service_id="svc_payments_api",
severity="sev1",
title="payments-api 5xx > 5% for 10m",
model="auto",
summarize=True,
)
print(incident.id, incident.summary["likely_cause"], incident.eridian.route)
TypeScript
import { Eridian } from "@eridian/sdk";
const client = new Eridian({
apiKey: process.env.ERIDIAN_API_KEY!,
projectId: "prj_ops_001",
});
const q = await client.ops.logs.query({
serviceId: "svc_auth",
model: "auto",
question: "500 errors from auth in the last hour",
from: "2026-09-08T13:00:00Z",
to: "2026-09-08T14:00:00Z",
});
See Pagination, Errors, Idempotency.