Skip to main content

API Reference

All Rodiun APIs use JSON over HTTPS. Authentication is via Authorization: Bearer <api_key> header.

Services​

ServiceBase URLDescription
Operon Runtimehttps://api.rodiun.ioOrb execution, receipts, hot-swap
Reputation Ledgerhttps://ledger.rodiun.ioOrb scoring, certification, marketplace
Policy Enginehttps://policy.rodiun.ioRego policy management, dry-run
Ingestionhttps://ingest.rodiun.ioVendor webhook ingestion (Datadog, Segment, Mixpanel)

Operon Runtime​

POST /orbisets/{id}/execute​

Execute an Orb within an Orbiset.

Request:

{
  "orb_id": "rodiun.notification-email@1.0.0",
  "inputs": {
    "to": "user@example.com",
    "from_address": "noreply@app.com",
    "subject": "Hello",
    "body": "World"
  }
}

Response:

{
  "run_id": "run_abc123",
  "status": "completed",
  "outputs": { "message_id": "msg_xyz" },
  "receipt": {
    "receipt_id": "rec_789",
    "trust_score": 95,
    "risk_level": "low",
    "signature_valid": true,
    "timestamp": "2026-03-11T10:00:00Z"
  },
  "execution_ms": 342
}

GET /receipts/{receipt_id}​

Retrieve an OPAL Trust Receipt.

GET /providers/{orb_id}/status​

Get the current active provider and hot-swap status for an Orb.

POST /providers/{orb_id}/swap​

Trigger a provider hot-swap for an Orb.

Request: { "provider": "sendgrid" }

GET /health​

Public health check endpoint.

Response: { "status": "ok", "version": "1.0.0", "uptime_seconds": 86400 }

Reputation Ledger​

GET /reputation/{orb_id}​

Get the reputation profile for an Orb.

GET /reputation/{orb_id}/certificate​

Get the certification tier certificate for an Orb.

GET /reputation/{orb_id}/badge​

Get an SVG reputation badge for embedding in docs or READMEs.

GET /marketplace/orbs​

List all published Orbs (authenticated). Supports ?tier=gold&limit=20&offset=0.

GET /marketplace/orbs/public​

List all published Orbs (unauthenticated, public). Returns name, description, certification tier, and reputation score only.

POST /marketplace/orbs/publish​

Publish an Orb to the Marketplace.

Status​

GET /status​

Public platform status endpoint.

{
  "status": "operational",
  "uptime_30d_pct": 99.97,
  "incidents": [],
  "services": {
    "operon": "operational",
    "reputation_ledger": "operational",
    "observable_engine": "operational",
    "ingestion": "operational"
  },
  "last_updated": "2026-03-11T10:00:00Z"
}