API Reference
Admin Endpoints
Control Plane API for managing tenants, projects, users, and organizations.
All admin endpoints require authentication and are scoped to the current tenant.
| Method | Path | Description |
|---|
POST | /v1/admin/projects | Create project |
GET | /v1/admin/projects | List projects (paginated) |
GET | /v1/admin/projects/{id} | Get project |
PATCH | /v1/admin/projects/{id} | Update settings, origins, redirects |
| Method | Path | Description |
|---|
POST | /v1/admin/projects/{id}/api-keys | Create API key (secret shown once) |
GET | /v1/admin/projects/{id}/api-keys | List API keys |
DELETE | /v1/admin/projects/{id}/api-keys/{key_id} | Revoke API key |
| Method | Path | Description |
|---|
GET | /v1/admin/projects/{id}/signing-keys | List signing keys |
POST | /v1/admin/projects/{id}/signing-keys/rotate | Rotate signing key |
| Method | Path | Description |
|---|
GET | /v1/admin/users | List users (paginated, searchable) |
GET | /v1/admin/users/{id} | Get user with sessions and orgs |
PATCH | /v1/admin/users/{id} | Update status or metadata |
DELETE | /v1/admin/users/{id} | Delete user |
| Method | Path | Description |
|---|
POST | /v1/admin/organizations | Create organization |
GET | /v1/admin/organizations | List organizations |
GET | /v1/admin/organizations/{id} | Get organization |
PATCH | /v1/admin/organizations/{id} | Update organization |
DELETE | /v1/admin/organizations/{id} | Delete organization |
| Method | Path | Description |
|---|
GET | /v1/admin/organizations/{id}/members | List members |
POST | /v1/admin/organizations/{id}/members | Add member |
PATCH | /v1/admin/organizations/{id}/members/{user_id} | Update role |
DELETE | /v1/admin/organizations/{id}/members/{user_id} | Remove member |
| Method | Path | Description |
|---|
POST | /v1/admin/organizations/{id}/invitations | Create invitation |
GET | /v1/admin/organizations/{id}/invitations | List invitations |
DELETE | /v1/admin/organizations/{id}/invitations/{inv_id} | Revoke invitation |
| Method | Path | Description |
|---|
POST | /v1/admin/webhooks | Create webhook (secret shown once) |
GET | /v1/admin/webhooks | List webhooks |
GET | /v1/admin/webhooks/{id}/deliveries | List deliveries |
POST | /v1/admin/webhooks/{id}/test | Send test event |
GET /v1/admin/audit?start_date=...&end_date=...&action=...&page=1&limit=50
{
"events": [
{
"id": "...",
"actor_type": "user",
"action": "user.created",
"resource_type": "user",
"ip_address": "1.2.3.4",
"created_at": "2026-01-15T10:00:00Z"
}
],
"pagination": { "page": 1, "limit": 50, "total": 1234 }
}
| Method | Path | Description |
|---|
GET | /health | Full health with DB + Redis checks |
GET | /health/ready | Readiness probe |
GET | /health/live | Liveness probe |