API reference - Omnifence API

Base URL

https://api.omnifence.ai

Moderation and platform endpoints are under /api/v1.

All endpoints 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 job exports, which stream text/csv; charset=utf-8)

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

Method	Path	Description
`GET`	`/api/v1/me/moderation-config`	Get moderation config
`PUT`	`/api/v1/me/moderation-config`	Update moderation config
`GET`	`/api/v1/me/custom-categories`	List custom categories
`POST`	`/api/v1/me/custom-categories`	Create a custom category
`POST`	`/api/v1/me/custom-categories/generate-prompt`	Draft a custom-category system prompt
`PUT`	`/api/v1/me/custom-categories/{id}`	Update a custom category
`DELETE`	`/api/v1/me/custom-categories/{id}`	Delete a custom category
`GET`	`/api/v1/me/terms`	Get terms status
`GET`	`/api/v1/me/terms/documents/{id}/file`	Download a legal document
`POST`	`/api/v1/me/terms/accept`	Accept terms

Method	Path	Description
`POST`	`/api/v1/webhook/register`	Register webhook
`DELETE`	`/api/v1/webhook/register`	Unregister webhook