API reference

Analysis

Stateless analysis endpoints that operate on an architecture graph you supply — reliability, security, simulation, prediction and reporting.

Graph in, analysis out

These endpoints take a graph (the architecture, as produced by a scan) in the request body. Read the latest graph from a scan and pass it here.

Reliability

POST/api/analyze/reliability

Returns a score, weighted findings and prioritized recommendations.

curl -X POST https://api.riscly.com/api/analyze/reliability \
  -H "Authorization: Bearer $RISCLY_TOKEN" \
  -H "x-org-id: $RISCLY_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"graph": { "nodes": [], "edges": [] }}'

Security

POST/api/analyze/security

Like reliability, plus an exposures array of externally reachable risks.

Simulate

POST/api/analyze/simulate
FieldTypeDescription
graphrequiredobjectThe architecture graph.
typerequiredstringSimulation type, e.g. node-outage.
paramsobjectType-specific parameters, e.g. the node to fail.
businessobjectBusiness context to express impact in money.
durationHoursnumberOutage window; defaults to 1.

Predict

POST/api/analyze/predict

AI failure prediction over a graph. Pass an optional currentUsers for scale-aware results.

Report

POST/api/analyze/report

Generates a consolidated report from a graph and optional business context.