# Update video.

Update video.

Endpoint: PUT /videos/{video_id}
Version: 1.0.0
Security: Token

## Path parameters:

  - `video_id` (string, required)
    The ID of a video. UUID Version 4.
    Example: "00000000-0000-4000-8000-000000000000"

## Request fields (application/json):

  - `title` (string, required)
    The name of the video.
    Example: "Home Walkthrough Video"

## Response 200 fields (application/json):

  - `status` (string, required)
    What was the state of the request?
    Example: "success"

  - `data` (object)
    A recording of moving visual images. Provided either as a download URL (MP4) or a link (e.g. YouTube, Vimeo).

  - `data.object` (string)
    A canonical value representing a resource.
    Enum: "VIDEO"

  - `data.id` (string, required)
    ID of the entity. UUID Version 4.
    Example: "00000000-0000-4000-8000-000000000000"

  - `data.title` (string,null)
    The title of the video given by the uploading user.
    Example: "The New Vimeo Player (You Know, For Videos)"

  - `data.duration` (integer,null)
    The video's runtime in seconds.
    Example: 360

  - `data.display_type` (string, required)
    The display type determines if the video is branded or unbranded (can also be none or both). This affects whether the video is displayed on branded or unbranded marketing materials such as the property website.
    Enum: "BRANDED", "UNBRANDED", "BOTH", "NONE"

  - `data.source_type` (string, required)
    The original upload source of the video, used to determine how to handle the playback_url of the video and other display properties.
    Enum: "YOUTUBE", "VIMEO", "OPTIMIZED", "UPLOADED", "LINK"

  - `data.thumbnail_url` (string, required)
    A thumbnail image URL for the video.
    Example: "https://picsum.photos/300"

  - `data.playback_url` (string,null, required)
    A URL linking to playback stream of the video.
    Example: "https://player.vimeo.com/video/76979871"

  - `data.download_url` (string,null)
    A URL for downloading the video.
    Example: "https://videos.aryeo.com/listings/00000000-0000-4000-8000-000000000000/00000000-0000-4000-8000-000000000000.mp4"

  - `data.share_url` (string,null)
    A URL linking to a public viewing optimized webpage the video.
    Example: "https://www.aryeo.com/v2/00000000-0000-4000-8000-000000000000/videos/1"

  - `timestamp` (string,null)
    The request timestamp (ISO 8601).
    Example: "2021-06-30T20:30:00Z"

## Response 403 fields (application/json):

  - `status` (string, required)
    What was the state of the request?
    Example: "error"

  - `message` (string, required)
    The error message.
    Example: "{ApiError message.}"

  - `code` (integer,null)
    A numeric code corresponding to the error.
    Example: 403

## Response 404 fields (application/json):

  - `status` (string, required)
    What was the state of the request?
    Example: "error"

  - `message` (string, required)
    The error message.
    Example: "{ApiError message.}"

  - `code` (integer,null)
    A numeric code corresponding to the error.
    Example: 404

## Response 422 fields (application/json):

  - `status` (string, required)
    What was the state of the request?
    Example: "fail"

## Response 500 fields (application/json):

  - `status` (string, required)
    What was the state of the request?
    Example: "error"

  - `message` (string, required)
    The error message.
    Example: "{ApiError message.}"

  - `code` (integer,null)
    A numeric code corresponding to the error.
    Example: 500