Media Governance Configuration API
The Media Governance Configuration API allows you to check feature availability, retrieve the current media governance settings, and update per-tenant configuration. These endpoints are served by the Orchestrator on port 8081 and are commonly reached through the Agent proxy.
For background on media governance concepts such as analyzers, system policies, and multimodal governance, see Media Governance.
Authentication
All endpoints require Basic authentication using your client ID and client secret:
curl http://localhost:8080/api/v1/media-governance/status \
-H "Authorization: Basic $(echo -n 'your-client-id:your-client-secret' | base64)"
Header compatibility: these endpoints accept both tenant derived from Basic auth (preferred) and
X-Org-ID(backward-compatible) for tenant identification.
Tier Restrictions
The update handler checks for a paid tier in code. In practice that means community and evaluation can read status and config, while paid deployments get per-tenant write control.
| Capability | Community | Evaluation | Paid tiers |
|---|---|---|---|
| Get feature status | Yes | Yes | Yes |
| Get media governance config | Yes | Yes | Yes |
| Enable or disable media governance per tenant | No | No | Yes |
| Restrict allowed analyzers per tenant | No | No | Yes |
Community and evaluation still have meaningful value here because they can confirm feature availability and understand the operational model before enabling more granular per-tenant controls in enterprise deployments.
Endpoints
GET /api/v1/media-governance/status
Returns the media governance feature availability for the authenticated tenant's tier.
GET /api/v1/media-governance/config
Returns the current media governance configuration for the authenticated tenant.
PUT /api/v1/media-governance/config
Updates the media governance configuration for the authenticated tenant. Paid-tier only.
Request Body:
| Field | Type | Required | Description |
|---|---|---|---|
enabled | bool | No | Enable or disable media governance for this tenant |
allowed_analyzers | []string | No | Restrict which analyzers the tenant can use |
Error Responses:
| HTTP Status | Code | Description |
|---|---|---|
| 400 | INVALID_REQUEST | Request body contains invalid fields or values |
| 401 | UNAUTHORIZED | Missing or invalid authentication |
| 403 | TIER_RESTRICTED | Configuration updates are not available on your tier |
Example:
{
"error": {
"code": "TIER_RESTRICTED",
"message": "Per-tenant media governance configuration requires an Enterprise license. Use the MEDIA_GOVERNANCE_ENABLED environment variable for platform-wide control."
}
}
