API reference

Base URL

https://api.omnifence.ai

Moderation and platform endpoints are under /api/v1. The health check is at the root (/health).

All endpoints except /health require a Bearer token in the Authorization header. See authentication for details.

Authorization: Bearer YOUR_API_KEY

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 return text/event-stream)

The API is versioned via URL path. The current version is v1. All moderation, job, usage, and webhook endpoints are prefixed with /api/v1/.

Requires the admin: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