media.resource.control

Generated at from openvibe-contracts v0.177.0 and openvibe-sdk v0.44.0.

Not grantable to apps (active, first-party).

Control a media object through OpenVibe.Media's control API (ADR-048, plan T13 step 10): POST /api/v1/resources/control takes one common.resource-control-request@1 naming a media.object by its OVRN, from a first-party service (OpenVibe.Services) acting for the person in on_behalf_of. Action: delete (a soft delete, exactly as DELETE /api/v1/objects/:id: the object stops being served at once and can be restored through the API until its retention period ends; an object under a retention hold, or a legacy VOD, clip or file managed through its own routes, is refused). Any other action is refused unsupported. Only the object's owner may act on it, and only inside the project the OVRN names. dry_run decides and explains without applying. The first answer per (caller, project, idempotency_key) is kept and returned for a repeat; the same key with another request is refused. Answers common.resource-control-result@1.

Owner
media (token audience openvibe.media)
Version
1.0
Status
active
Visibility
first-party
Resource constraints
project
Quota class
standard
Permissions
resources:control
Input
common.resource-control-request@1
Output
common.resource-control-result@1
Events
—
Implemented by
  • POST /api/v1/resources/control

These routes in the API explorer