# Add a video for use in content of type article

Add a new video to a content record. Response body is the attributes of the video record. Insert the returned embed_html into the body of the article at the location you want the video to appear in the article.

Endpoint: PUT /v2/content/{content_id}/videos
Version: v2
Security: oauth2_as_a_user, oauth2_as_a_server

## Path parameters:

  - `content_id` (integer, required)
    ID or UUID of the content post

## Request fields (application/json):

  - `video_url` (string, required)
    URL of the video to add.
    Example: "https://some.video.url"

  - `caption` (string)
    Video caption
    Example: "Watch out!"

  - `preview_image_url` (string)
    Video preview image URL
    Example: "https://preview_image.video.url"

## Response 201 fields (application/json):

  - `data` (array, required)

  - `data.id` (integer)
    The unique identifier of this video record

  - `data.uuid` (string)
    The unique uuid identifier of this video record. Used in public urls.
    Example: "205ba32a-7f12-439d-b33d-df1c611c8e9c"

  - `data.caption` (string)
    A caption description of this video.
    Example: "Example video caption"

  - `data.source` (string)
    Enum: "youtube", "vimeo", "socialchorus", "socialchorus_galaxy", "office365"

  - `data.state` (string)
    Enum: "completed", "submitted", "error"

  - `data.duration` (integer)
    Length of the video in seconds
    Example: 30

  - `data.preview_image_url` (string)
    A url to an image that acts as a poster for the video before the video is loaded.

  - `data.embed_html` (string)
    An HTML iframe widget that can be used to embed the video in an article.
    Example: "<iframe href='https://onfirstup.com/acme/acmetimes/sc4#contents/456/videos/abc123'></iframe>\n"

  - `data.link_url` (string)
    A link to the video where it can be played
    Example: "https://onfirstup.com/acme/acmetimes/sc4#contents/456/videos/abc123"

  - `data.created_at` (string)
    Example: "2000-01-01T00:00:00Z"

## Response 401 fields (*/*):

  - `errors` (array)

  - `errors.code` (integer)
    Example: 401

  - `errors.title` (string)
    Example: "Unauthenticated"

  - `errors.detail` (string)
    Example: "Access token was not provided or not recognized."

## Response 403 fields (*/*):

  - `errors` (array)

  - `errors.code` (integer)
    Example: 403

  - `errors.title` (string)
    Example: "Unauthorized"

  - `errors.detail` (string)