Retrieve security settings
/settings/securityReturns the content protection settings of the account: social DRM watermark, YouTube player protection, and video provider integrations.
Provider credentials are never returned; the configured fields indicate whether they have been set.
The response includes an ETag representing the current revision. Send this value in the If-Match header when updating these settings to avoid overwriting a newer version.
Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/settings/security"{ "data": { "defaults": {}, "drm": { "enabled": true, "social": { "background_color": "string", "opacity": "string", "position": "top", "text_color": "string" }, "youtube": { "enabled": true, "position": "top-left" } }, "object": "settings", "propagation": {}, "providers": { "panda": { "available": true, "configured": true, "enabled": true, "group_id": "string" }, "vdocipher": { "configured": true, "enabled": true, "watermark": true, "whitelist": true }, "videofront": { "configured": true, "enabled": true } }, "replica": {}, "revision": "string" }}Update registration settings PATCH
Updates the registration settings. Only the fields included in the request are changed: setting a field to `null` clears its configured value and restores the default, and omitted fields are left unchanged. To avoid overwriting a newer version, send the `ETag` returned by the retrieve operation in the `If-Match` header. The header is optional; when it is omitted, the update is applied to the current revision.
Update security settings PATCH
Updates the content protection settings. Only the fields included in the request are changed: setting a field to `null` clears its configured value and restores the default, and omitted fields are left unchanged. Provider credentials are write-only. Enabling a video provider requires its credentials. To avoid overwriting a newer version, send the `ETag` returned by the retrieve operation in the `If-Match` header. The header is optional; when it is omitted, the update is applied to the current revision.