BRbrightcovelearning
Media Sharing

Share Video

Changed on

Shares a video to one or more affiliates - this is an Master account operation - if the video has already been shared to an affiliate, this operation will re-share it and overwrite any affiliate metadata changes

post/v1/accounts/{{account_id}}/videos/{{video_id}}/shares

Request

  • Base URL
    https://cms.api.brightcove.com
  • URL
    https://cms.api.brightcove.com/v1/accounts/{{account_id}}/videos/{{video_id}}/shares
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://oauth.brightcove.com/v4/access_token scopes: video-cloud/video/create

Path parameters

account_idstring required

Video Cloud account ID.

video_idstring required

Video ID (specified as {video_id}}).

Headers

Content-Typestring required

Content-Type: application/json

Authorizationstring required

Authorization: Bearer {access_token} - see Getting Access Tokens

Request body

idstring required

affiliate account id to share to

Response

Share request accepted

affiliate_idstring required

the id of the affiliate account the video is shared to

affiliate_video_idstring required

the id of the shared video in the affiliate account

shared_atstring

when the video was shared

statusstring

the status of the sharing - either PROCESSING, COMPLETE, or FAILED

updated_atstring

the video was last updated in the affiliate account

video_idstring required

the video id

Changes