API Reference

The SOVR API is organized around REST. All requests and responses use JSON.

Base URL

https://sovrapp.com/api/sovr

Authentication

All API requests require authentication via API key:

curl -X POST https://sovrapp.com/api/sovr/gate/check \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk_..." \
  -H "x-tenant-id: your-tenant-id" \
  -d '{"action": "send_email", "context": {}}'

Response Format

Success:

{
  "success": true,
  "data": { ... }
}

Error:

{
  "success": false,
  "error": "error_code",
  "message": "Human readable message"
}

Rate Limits

Plan	Requests/minute
Free	60
Pro	600
Enterprise	Unlimited

Endpoints

Endpoint	Description
POST /gate/check	Execute gate check
POST /gate/risk	Risk assessment
GET /approvals	List pending approvals
POST /approvals/:id/approve	Approve request
POST /approvals/:id/reject	Reject request
GET /audit/chain	Get audit trail
POST /audit/verify	Verify chain integrity
GET /killswitch/status	Get kill switch status
POST /killswitch/trigger	Trigger emergency stop
POST /killswitch/recover	Recover from halt
GET /evidence/bundle/:id	Export trust bundle
POST /evidence/verify	Verify trust bundle