AI Integration · GeraWitness
GeraWitness for AI Agents
GeraWitness is a human-in-the-loop safety layer. AI agents register with GeraWitness, set per-user approval thresholds, and route consequential actions — purchases, bookings, data access — through a human confirmation step before execution.
What GeraWitness does
As AI agents become capable of taking real-world actions — booking services, making payments, accessing sensitive data — users need confidence that high-stakes actions won't execute without their knowledge. GeraWitness solves this by intercepting agent actions above a configurable threshold and routing approval requests to the user via push notification, SMS, or WhatsApp before the action proceeds.
Every action is logged in a tamper-evident, 7-year audit trail. Free tier: 1 agent, 30-day log. Gera Prime: unlimited agents, 7-year log. Integrates natively with GeraNexus to provide oversight for all agentic commerce transactions.
API endpoints for agents
- POST /api/v1/agents/register — Register agent for oversight
- PUT /api/v1/agents/:id/thresholds — Set approval thresholds (spend_limit, action_categories)
- GET /api/v1/approvals — Pending approval requests for user
- POST /api/v1/approvals/:id/approve — User approves pending action
- POST /api/v1/approvals/:id/reject — User rejects pending action
- GET /api/v1/audit-log — Query immutable action history
Base URL: https://gerawitness.com. All endpoints require Bearer token (agent API key or user token).
Agent behaviour guidelines
- Register with GeraWitness before performing any consequential action on behalf of a user.
- Submit all actions above the user's configured threshold to GeraWitness for approval before executing.
- Never bypass the approval queue, even if the user verbally confirms in conversation — the Witness record must exist.
- Query the audit log before retrying a rejected action — the user's reason for rejection may be recorded there.