Documentation Index
Fetch the complete documentation index at: https://docs.omnifence.ai/llms.txt
Use this file to discover all available pages before exploring further.
Base URL
/api/v1. The health check is at the root (/health).
Authentication
All endpoints except/health require a Bearer token in the Authorization header. See authentication for details.
Content types
- Moderation submissions:
multipart/form-data(prompt text and image/video URLs sent as form fields) - Other requests:
application/json - All responses:
application/json(except SSE progress streams which returntext/event-stream)
Versioning
The API is versioned via URL path. The current version isv1. All moderation, job, usage, and webhook endpoints are prefixed with /api/v1/.
Endpoints
Client endpoints
| Method | Path | Description |
|---|---|---|
GET | /health | Health check |
POST | /api/v1/moderate/prompt | Submit prompt moderation |
POST | /api/v1/moderate/image | Submit image moderation |
POST | /api/v1/moderate/video | Submit video moderation |
GET | /api/v1/job/{id} | Get job status |
GET | /api/v1/job/{id}/progress | Stream job progress |
GET | /api/v1/usage | Get usage summary |
POST | /api/v1/webhook/register | Register webhook |
Admin endpoints
Requires theadmin:config scope. See authentication.
| Method | Path | Description |
|---|---|---|
GET | /api/v1/admin/keywords | List keywords |
POST | /api/v1/admin/keywords | Create keyword |
DELETE | /api/v1/admin/keywords/{id} | Delete keyword |
GET | /api/v1/admin/prompts | List prompts |
GET | /api/v1/admin/prompts/{slug} | Get prompt |
PUT | /api/v1/admin/prompts/{slug} | Update prompt |
POST | /api/v1/admin/prompts/test | Test prompt |
GET | /api/v1/admin/models/{provider} | List models |
DELETE | /api/v1/admin/models/{provider}/cache | Invalidate models cache |
GET | /api/v1/admin/clients | List clients |
GET | /api/v1/admin/clients/{id} | Get client |
PUT | /api/v1/admin/clients/{id} | Update client |
POST | /api/v1/admin/clients/{id}/ban | Ban client |
POST | /api/v1/admin/clients/{id}/unban | Unban client |
POST | /api/v1/admin/clients/{id}/keys/{hash}/revoke | Revoke API key |
POST | /api/v1/admin/clients/{id}/keys/{hash}/activate | Activate API key |
GET | /api/v1/admin/stats | Get stats |
GET | /api/v1/admin/jobs | List jobs |
GET | /api/v1/admin/queues | Get queues |
