Skip to content

Approvals API

GET /approvals

List pending approvals.

bash
curl https://sovrapp.com/api/sovr/approvals \
  -H "x-api-key: sk_..." \
  -H "x-tenant-id: tenant_123"

Response

json
{
  "success": true,
  "data": [
    {
      "id": "apr_abc123",
      "action": "send_contract",
      "status": "pending",
      "createdAt": "2026-02-05T05:00:00Z",
      "context": { "value": 100000 }
    }
  ]
}

POST /approvals/:id/approve

Approve a pending request.

bash
curl -X POST https://sovrapp.com/api/sovr/approvals/apr_abc123/approve \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk_..." \
  -H "x-tenant-id: tenant_123" \
  -d '{
    "approverId": "user_xyz",
    "comment": "Looks good"
  }'

POST /approvals/:id/reject

Reject a pending request.

bash
curl -X POST https://sovrapp.com/api/sovr/approvals/apr_abc123/reject \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk_..." \
  -H "x-tenant-id: tenant_123" \
  -d '{
    "approverId": "user_xyz",
    "reason": "Amount exceeds budget"
  }'

The AI Responsibility Layer