Eridian

Risk API

REST reference for cases, assessments, evidence, and reports.

Base URL: https://api.geteridian.com/v1. Keys: eridian_sk_. Models: gpt, gemini, auto.

Scopes

ScopeAccess
risk:readGET cases, evidence metadata, assessments, reports
risk:writeOpen cases, attach evidence, draft assessments and reports
risk:approveApprove gated Risk actions (or governance:manage)
audit:readEvidence export

Cases

MethodPath
POST/v1/risk/cases
GET/v1/risk/cases
GET/v1/risk/cases/{id}
POST/v1/risk/cases/{id}/assign
POST/v1/risk/cases/{id}/status
POST/v1/risk/cases/{id}/notes
PATCH/v1/risk/cases/{id}/fc
POST/v1/risk/cases/{id}/fc/brief
POST/v1/risk/cases/{id}/hold

Evidence, controls, assessments, reports

MethodPath
POST/v1/risk/cases/{id}/evidence
GET/v1/risk/cases/{id}/evidence
GET/v1/risk/evidence/{id}
GET/v1/risk/evidence/{id}/content
GET/v1/risk/controls
POST/v1/risk/controls/map
POST/v1/risk/controls/map/{id}/gap
POST/v1/risk/assessments
POST/v1/risk/assessments/{id}/submit
POST/v1/risk/reports
GET/v1/risk/reports/{id}/content

Approvals: Dual Control /v1/approvals.

Objects

objectId prefix
eridian.risk.casecse_
eridian.risk.evidenceevd_
eridian.risk.assessmentras_
eridian.risk.control_mapcem_
eridian.risk.reportrpt_
eridian.risk.fc.brieffcb_

Errors

HTTPCodeWhen
409segregation_of_dutiesAssignee equals reviewer
409evidence_immutableByte mutate
403dual_control_requiredGated action
409case_heldDestructive write under hold
422structured_output_failedAssessment without citations

Python

from eridian import Eridian

client = Eridian(api_key="eridian_sk_...", project_id="prj_risk_001")

case = client.risk.cases.create(
    title="Unusual outbound series on desk PX-12",
    typology="fraud",
    severity="high",
    model="auto",
    triage=True,
)
print(case.id, case.status, case.eridian.route)

TypeScript

import { Eridian } from "@eridian/sdk";

const client = new Eridian({
  apiKey: process.env.ERIDIAN_API_KEY!,
  projectId: "prj_risk_001",
});

const report = await client.risk.reports.create({
  caseId: "cse_0912",
  templateId: "tpl_fc_narrative_v2",
  model: "gpt",
  evidenceIds: ["evd_01", "evd_02"],
});

See Pagination and Idempotency.

Production API credentials are issued with an institution workspace. Contact sales if you need access.