API Reference
EmbiPay exposes REST APIs for Admin (Bearer token) and Agent (agent_key) operations. Rate limited at 60 requests/minute.
Authentication
- Admin API:
Authorization: Bearer <ADMIN_API_TOKEN>or Supabase session JWT (user in adminkeys) - Agent API:
Authorization: Bearer <agent_key>
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /api/admin/create-wallet | Create agent wallet |
| POST | /api/admin/create-shared-pool | Create shared expense pool |
| POST | /api/admin/contribute-to-pool | Contribute to pool (with optional usage_limit) |
| GET | /api/admin/pool-details | Get pool with allocation breakdown |
| POST | /api/admin/record-pool-usage | Record pool usage (blocks when exhausted; -1=unlimited) |
| POST | /api/admin/pool-exit | Remove agent from pool (Milestone 3) |
| GET | /api/admin/pool-overuse | List contributions with usage_limit < -1 (overuse) |
| POST | /api/admin/create-loan | Create A2A loan |
| POST | /api/admin/approveLoan | Approve loan |
| POST | /api/admin/record-repayment | Record loan repayment |
| GET | /api/admin/loan-details | Get loan with schedule |
| GET | /api/admin/fetch-a2a-loans | List all A2A loans |
| POST | /api/admin/register-webhook | Register webhook URL |
| GET | /api/admin/register-webhook | List registered webhooks |
| GET | /api/admin/fetchAllLedgers | Fetch ledger entries |
| GET | /api/agent/fetch-tasks | Agent: fetch pending tasks |
| POST | /api/agent/complete-task | Agent: complete task |
| POST | /api/agent/feedback | Agent: send feedback (bug, suggestion) |
OpenAPI Specification
Download the OpenAPI 3.0 spec for tooling and code generation:
api-spec.json →