DOCS · COMPLIANCE

Compliance classify API

Gate a mutation path. Get a portable audit receipt. See it on VER++. Week-1 CI needs no API key. Production agents should use MCP with a Bearer key when minted.

Integration paths

Direct (pilot)	POST /api/compliance	None	Week-1 CI
MCP	POST /api/mcp	Bearer SKENAI_API_KEY	Production agents
Human	ratio.skenai.net/#classify	Session	Explicit confirm

Direct classify (no key)

curl -sS -X POST https://skenai.net/api/compliance \
  -H "Content-Type: application/json" \
  -d '{
    "item_name": "pr-candidate",
    "tenant_id": "your-tenant",
    "description": "CI classify probe",
    "scope": "defense",
    "surface": "ratio_portal",
    "trigger": "explicit"
  }'

Response includes audit_id, verdict, proof_hash. Verify: GET /api/proof/verify?proof_hash=<hash>

MCP (Bearer)

curl -sS -X POST https://skenai.net/api/mcp \
  -H "Authorization: Bearer $SKENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "id": 1,
    "params": {
      "name": "skenai-william-compliance",
      "arguments": {
        "item_name": "your-artifact",
        "tenant_id": "your-tenant",
        "description": "optional"
      }
    }
  }'

Key mint is ops / tenant award — not self-serve on first visit. Discovery: /.well-known/agents.json