---
title: "Update a Specific Video"
method: PATCH
path: "/api/v2/content/videos/{id}"
tags: ["Content - Videos"]
---

# Update a Specific Video

`PATCH /api/v2/content/videos/{id}`

This endpoint updates supplied fields for a specific video. The `PATCH` request does not support the `X-Degreed-Organization-Code` header. <h3>Required Scope</h3>`content:write`

## Path parameters

- `id` string, required

## Request body

- VideosIdBody
  - `data` Apiv2contentvideosidData
    - `attributes` Apiv2contentvideosidDataAttributes
      - `title` string — The title of the video.
      - `summary` string, nullable — Short summary of the video.
      - `url` string — URL location where more information can be found.
      - `obsolete` boolean — If the video should be marked as obsolete.
      - `image-url` string, nullable — Cover image of the video.
      - `language` string, nullable — Spoken language of the video.
      - `duration` number, nullable — Length of the video. Type is supplied with `duration-type`.
      - `duration-type` string, nullable — Seconds, minutes, hours, or days.
      - `learning-minutes` integer — The calculated value that corresponds with the learning minutes displayed on content cards in the UI. For example, if the duration of a video is 300 seconds, this is equal to 5 `learning-minutes`.
      - `publish-date` string, date-time, nullable — Date that the video was published.
      - `format` string, nullable — The format of the video. This value appears in the UI as a filter option in search. Previously, only a list of acceptable values were allowed, however, now any value is allowed.
      - `owner-id` string — The unique ID of the group or user that owns the content.
      - `owner-type` string — Must be either "user" or "group".

## Response `200`

Success

- Video
  - `data` ListedVideoData
    - `type` string
    - `id` string
    - `attributes` ListedVideoAttributes
      - `provider-code` string, nullable — Unique provider code.
      - `title` string, nullable — The title of the video.
      - `summary` string, nullable — Short summary of the video.
      - `url` string, nullable — URL location where more information can be found.
      - `degreed-url` string, nullable — URL location of video within Degreed UI.
      - `obsolete` boolean
      - `image-url` string, nullable — Cover image of the video.
      - `language` string, nullable — The language of the video.
      - `duration` integer, nullable — The duration of the video.
      - `duration-type` string, decimal, nullable — The duration type of the video.
      - `learning-minutes` integer — The calculated value that corresponds with the learning minutes displayed on content cards in the UI. For example, if the duration of a video is 300 seconds, this is equal to 5 `learning-minutes`.
      - `owner-id` string — The unique ID of the group or user that owns the content.
      - `owner-type` string — Must be either "user" or "group".
      - `publish-date` string, date-time, nullable — Date that the video was published. (UTC)
      - `created-at` string, date-time — Date that the video was created. (UTC)
      - `modified-at` string, date-time — Date that the video was last modified. (UTC)
      - `external-id` string, nullable — The external ID of the video.
      - `format` string, nullable — The format of the video. Possible values include `Documentary` or `Online`.
      - `is-internal` boolean, nullable — Indicates whether the content is owned by the organization and is not part of Degreed's external catalog. Internal content includes content that was created by the organization or shared with the organization through a bundle.
      - `groups-with-access` string[] — Groups that have access to the content item.
      - `groups-with-access-ids` string[] — IDs of the groups that have access to the content item.
    - `links` SelfLink
      - `self` string

---

[API](https://skmtc.net/degreed/apis/degreed-api-web.md) · [All operations](https://skmtc.net/degreed/apis/degreed-api-web/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/degreed/degreed-api-web/revisions/4a22b709515c/schema)