Rivier/ Reference/ files

Set chapters, captions, audio tracks or the transcript of a video or audio file

put/assets/{id}/media-facts

Set chapters, captions, audio tracks or the transcript of a video or audio file. A model's drafts are held as unreviewed until a person reviews them.

Before you call

Credential
Authorization: Bearer $KEY
Scope
files:write
Mcp
rivier_assets_media_facts
Graphql
Mutation.filesAssetMediaFacts
Sdk
files.asset.mediaFacts
Cli
files asset media facts
Events
files.asset.updated

Parameters

  • idstring (uuid)required
    In the path

Request bodyapplication/json, required

  • chapterslist of object
    Default: [].
    • startnumberrequired
      At least 0.
    • titlestringrequired
      At most 120 characters.
    • thumbnailstring
      Pattern: ^[A-Za-z0-9._-]{1,80}$.
    • aiGeneratedboolean
      Default: false.
    • reviewedboolean
      Default: false.
    • reviewedBystring
      At most 200 characters.
  • captionslist of object
    Default: [].
    • langstringrequired
      At most 12 characters.
    • kindstringrequired
      One of: subtitles, captions.
    • assetIdstring (uuid)
    • vttstring
      At most 500000 characters.
    • aiGeneratedboolean
      Default: false.
    • reviewedboolean
      Default: false.
    • reviewedBystring
      At most 200 characters.
  • audioTrackslist of object
    Default: [].
    • langstringrequired
      At most 12 characters.
    • labelstringrequired
      At most 60 characters.
  • transcriptobject or null
    Default: null.
  • posterAtSecondsnumber or null
    Default: null.

Responses

  • 200application/json
    Success
    • 400application/json
      The request was malformed
      • errorstringrequired
      • messagestring
    • 401application/json
      No valid credential
      • errorstringrequired
      • messagestring
    • 403application/json
      The credential lacks the scope, origin or address
      • errorstringrequired
      • messagestring
    • 429application/json
      Over the key's rate limit; see Retry-After
      • errorstringrequired
      • messagestring

    This page as Markdown