Skip to main content
PUT
Create or extend the time-boxed hold that keeps committed media bytes

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

referenceId
string<uuid>
required

Opaque reference identifier

Body

application/json
ttlDays
integer
required
Required range: 1 <= x <= 365

Response

Current media hold for the reference

referenceId
string
required
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
mediaId
string
required
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
expiresAt
string
required
Pattern: ^\d{4}-(0[1-9]|1[0-2])-([0-2]\d|3[01])T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,9})?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$
reason
enum<string>
required
Available options:
ingestion_request,
explicit_extension
revision
integer
required
Required range: 0 <= x <= 9007199254740991