API Documentation

C.R.E.E.D. API Reference

Base URL: https://creed.kytranempowerment.com/api/v1
All endpoints accept and return JSON. Badge endpoints return SVG images.

POST /api/v1/events

Ingest a governance event into the C.R.E.E.D. compliance database.

Request
curl -X POST https://creed.kytranempowerment.com/api/v1/events \
  -H "Content-Type: application/json" \
  -d '{
    "event_type": "policy_violation",
    "source_platform": "archie",
    "agent_id": "agent_042",
    "agent_name": "V.I.G.I.L.",
    "category": "data_protection",
    "severity": "warning",
    "description": "Unencrypted PII detected in log output",
    "metadata": {"file": "output.log", "line": 42}
  }'
Response (201)
{"success": true, "event_id": 127}
GET /api/v1/events

List governance events with optional filtering.

Query Parameters
  • category — filter by category (e.g. data_protection, transparency)
  • severity — filter by severity (info, warning, violation, critical)
  • limit — max results, default 50, max 500
  • offset — pagination offset, default 0
Request
curl "https://creed.kytranempowerment.com/api/v1/events?category=data_protection&limit=10"
Response (200)
{
  "events": [
    {
      "id": 127,
      "event_type": "policy_violation",
      "source_platform": "archie",
      "agent_id": "agent_042",
      "agent_name": "V.I.G.I.L.",
      "category": "data_protection",
      "severity": "warning",
      "description": "Unencrypted PII detected in log output",
      "created_at": "2026-04-14T12:00:00"
    }
  ],
  "limit": 10,
  "offset": 0
}
GET /api/v1/scores

Get computed compliance scores across all governance categories.

Query Parameters
  • days — scoring window in days, default 30
Request
curl "https://creed.kytranempowerment.com/api/v1/scores?days=30"
Response (200)
{
  "overall_score": 92.5,
  "grade": "A",
  "total_events": 384,
  "categories": {
    "data_protection": {"score": 95.0, "grade": "A+", "events": 48},
    "transparency": {"score": 88.0, "grade": "B+", "events": 61}
  }
}
GET /api/v1/audit

Get the audit log of administrative actions.

Query Parameters
  • limit — max results, default 50, max 500
  • offset — pagination offset, default 0
Request
curl "https://creed.kytranempowerment.com/api/v1/audit?limit=5"
Response (200)
{
  "entries": [
    {
      "id": 1,
      "user_id": 1,
      "action": "login",
      "details": "Admin login from 192.168.1.100",
      "ip_address": "192.168.1.100",
      "created_at": "2026-04-14T10:30:00"
    }
  ],
  "limit": 5,
  "offset": 0
}
GET /api/v1/badge/<type>

Get an SVG compliance badge. Types: overall, or any category name (e.g. data_protection).

Request
curl "https://creed.kytranempowerment.com/api/v1/badge/overall"
Embed (HTML)
<img src="https://creed.kytranempowerment.com/api/v1/badge/overall" alt="C.R.E.E.D. Compliance">
Embed (Markdown)
![C.R.E.E.D. Compliance](https://creed.kytranempowerment.com/api/v1/badge/overall)