Update a video

DEPRECATED: Updates to a video will be overwritten by any subsequent changes to its associated player. To make changes to the video, use the player endpoint to update the Player object instead.

Supported Formats

json

Errors

Code Description
400 Bad Request: body has wrong syntax or unable to handle request
401 Unauthorized: auth_token omitted or authentication failed
403 Forbidden: This action cannot be performed
404 Not Found: The requested resource could not be found
406 Not Acceptable: Accept or Content-Type headers must be application/json, text/csv or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
422 Unprocessable Entity: body has wrong attributes

Examples

REQUEST
Content-Type: application/json
{
  "name": "My Awesomest Video",
  "description": "They are compiling!",
  "organization_id": 20,
}

RESPONSE
200 (OK)
{
  "id": 2222,
  "organization_id": 20,
  "uuid": "4epPofk8TYhIanJLgZyIeA",
  "name": "My Awesomest Video",
  "upload_url": "http://myvideos.com/video.mp4",
  "description": "They are compiling!",
  "notes": "This video shows our old logo we should replace it soon...",
  "audio_gain": 20,
  "webhook_url": "http://callbacktest.herokuapp.com/",
  "sync": true,
  "status": "ready",
  "approver: "approver.user@organization.com",
  "error_message": null,
  "created_at": 1346961610,
  "updated_at": 1346961610
}

Params

Param name Description
auth_token
optional

API token needed to authorize requests
This can appear as an attribute in the body of the request or the query parameters on the URL

Validations:

  • Must be a String

id
required

Validations:

  • Parameter has to be Integer.

name
optional

Name of the video

Validations:

  • Must be a String

description
optional

Description to be shown with the video

Validations:

  • Must be a String

notes
optional

Your notes about the video
Notes are not shown to viewers

Validations:

  • Must be a String

sync
optional

If this video is pushed to YouTube, we will keep this video’s details in sync anytime you change them on Vidyard
Default: true

Validations:

  • Parameter has to be Boolean.

approver
optional

Approver email

Validations:

  • Must be a String