REST API Reference

1
{
2
  "user_id": "usr_...",
3
  "workspace_id": "ws_...",
4
  "org_id": "org_..."
5
}

1
{
2
  "record_type": "ai_risk_assessment",
3
  "payload": {
4
    "risk_level": "limited",
5
    "risk_summary": "Customer support routing",
6
    "intended_purpose": "Route customer queries to the correct team",
7
    "impact_domains": ["customer_service"],
8
    "art5_self_assessment": true
9
  },
10
  "system_name": "customer-support-ai",
11
  "identity": "alice@example.com",
12
  "resource": "customer-support-ai",
13
  "environment": "production",
14
  "occurred_at": "2026-06-28T09:00:00Z",
15
  "client_sig": "abc123...",
16
  "client_sig_algo": "hmac-sha256"
17
}

1
{
2
  "record_id": "rec_...",
3
  "record_type": "ai_risk_assessment",
4
  "mapped_controls": ["EUAIA_ART9", "ISO42001_6_1"],
5
  "detail": "ok"
6
}

1
{
2
  "record_id": "00000000-0000-0000-0000-000000000000",
3
  "record_type": "ai_risk_assessment",
4
  "mapped_controls": ["EUAIA_ART9", "ISO42001_6_1"],
5
  "detail": "dry_run"
6
}

1
{
2
  "system_name": "my-pipeline",
3
  "agent_name": "my-pipeline",
4
  "tool_name": "generate_report",
5
  "input_hash": "e3b0c44...",
6
  "output_hash": "d4e8f23...",
7
  "schema_version": 2,
8
  "executed_at": "2026-06-28T09:00:00Z",
9
  "model_id": "claude-opus-4-6",
10
  "authorised_by": {
11
    "identity": "alice@example.com",
12
    "role": "ml-engineer"
13
  }
14
}

1
{
2
  "attestation_id": "att_...",
3
  "external_verified": true,
4
  "trust_tier": "witnessed",
5
  "detail": "ok"
6
}

1
{
2
  "records": [
3
    { "system_name": "...", "tool_name": "...", "input_hash": "...", "output_hash": "...", "schema_version": 2 },
4
    { "system_name": "...", "tool_name": "...", "input_hash": "...", "output_hash": "...", "schema_version": 2 }
5
  ]
6
}

1
{
2
  "accepted": 2,
3
  "rejected": 0,
4
  "results": [
5
    { "status": "accepted", "attestation_id": "att_..." },
6
    { "status": "accepted", "attestation_id": "att_..." }
7
  ]
8
}

1
{
2
  "overall_score": 74,
3
  "frameworks": {
4
    "EU_AI_ACT": { "score": 71, "controls_earned": 8, "controls_total": 14 },
5
    "ISO_42001": { "score": 79, "controls_earned": 11, "controls_total": 16 },
6
    "SOC2": { "score": 82, "controls_earned": 9, "controls_total": 12 }
7
  },
8
  "open_gaps": 6,
9
  "gates_passing": 3,
10
  "gates_total": 5
11
}

1
{
2
  "systems": [
3
    {
4
      "system_id": "sys_...",
5
      "system_name": "customer-support-ai",
6
      "registered": true,
7
      "risk_tier": "limited",
8
      "last_evidence_at": "2026-06-28T09:00:00Z"
9
    }
10
  ]
11
}

1
{
2
  "records": [
3
    {
4
      "record_id": "rec_...",
5
      "record_type": "model_evaluation",
6
      "system_name": "loan-scorer",
7
      "occurred_at": "2026-06-28T09:00:00Z",
8
      "mapped_controls": ["EUAIA_ART9_4"],
9
      "source": "sdk",
10
      "signed": true
11
    }
12
  ]
13
}

1
{
2
  "gates": [
3
    {
4
      "gate_id": "g_quarterly_eval",
5
      "name": "Quarterly model evaluation",
6
      "passing": true,
7
      "blocking": false,
8
      "exit_code": 0
9
    },
10
    {
11
      "gate_id": "g_risk_assessment",
12
      "name": "AI risk assessment",
13
      "passing": false,
14
      "blocking": true,
15
      "exit_code": 2,
16
      "reason": "No ai_risk_assessment record in the last 180 days for loan-scorer"
17
    }
18
  ]
19
}

1
{
2
  "description": "A classification model that routes customer support tickets",
3
  "risk_tier": "limited"
4
}

1
{
2
  "recommendations": [
3
    {
4
      "record_type": "ai_risk_assessment",
5
      "priority": "required",
6
      "controls": ["EUAIA_ART9", "ISO42001_6_1"]
7
    },
8
    {
9
      "record_type": "model_evaluation",
10
      "priority": "required",
11
      "controls": ["EUAIA_ART9_4", "ISO42001_9_1"]
12
    }
13
  ]
14
}

1
{"occurred_at":"2026-06-28T09:00:00Z","payload":{...sorted keys...},"record_type":"ai_risk_assessment","system_name":"loan-scorer","workspace_id":"ws_..."}

1
{
2
  "error": "validation_error",
3
  "message": "record_type is required",
4
  "field": "record_type"
5
}