---
title: "Update a Specific Article"
method: PATCH
path: "/api/v2/content/articles/{id}"
tags: ["Content - Articles"]
---

# Update a Specific Article

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

This endpoint updates supplied fields for a specific article. 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

- ArticlesIdBody1
  - `data` Apiv2contentarticlesidData1
    - `attributes` Apiv2contentarticlesidData1Attributes
      - `title` string, nullable — The title of the article.
      - `summary` string, nullable — Short summary of the article.
      - `url` string, nullable — The URL where the article can be found.
      - `obsolete` boolean — If the article should be marked as obsolete.
      - `image-url` string, nullable — Image which will be shown on the content cards at Degreed.
      - `num-words` integer, nullable — The number of words in the article.
      - `learning-minutes` integer — The calculated value that corresponds with the learning minutes displayed on content cards in the UI. For example, if the `num-words` is 250, this is equal to 1 `learning-minutes`.
      - `publish-date` string, date-time — Date the article was published.
      - `format` string — The format of the article. 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

- Article
  - `data` ArticleData
    - `type` string
    - `id` string
    - `attributes` ArticleDataAttributes
      - `title` string, nullable — The title of the article.
      - `summary` string, nullable — Short summary of the article.
      - `url` string, nullable — URL location where more information can be found.
      - `format` string, nullable — The format of the article.
      - `obsolete` boolean
      - `image-url` string, nullable — Cover image of the article.
      - `language` string, nullable — The language of the article.
      - `num-words` integer, nullable — The number of words in the article.
      - `learning-minutes` integer — The calculated value that corresponds with the learning minutes displayed on content cards in the UI. For example, 250 `num-words` is equal to 1 learning minute.
      - `provider-code` string, nullable — Unique provider code.
      - `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 article was published. (UTC)
      - `created-at` string, date-time — Date that the article was created. (UTC)
      - `modified-at` string, date-time — Date that the article was last modified. (UTC)
      - `degreed-url` string, nullable — URL location of the article within Degreed UI.
      - `external-id` string, nullable — The external ID of the article.
      - `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[] — List of group IDs that can access the content.
      - `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)