---
title: "Update a Specific Book"
method: PATCH
path: "/api/v2/content/books/{id}"
tags: ["Content - Books"]
---

# Update a Specific Book

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

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

- BooksIdBody
  - `data` Apiv2contentbooksidData
    - `type` string
    - `attributes` Apiv2contentbooksidDataAttributes
      - `title` string — The title of the book.
      - `subtitle` string, nullable — The subtitle of the book.
      - `authors` string, nullable — Comma delimited list of authors.
      - `pages` integer, nullable — Number of pages.
      - `learning-minutes` integer — The calculated value that corresponds with the learning minutes displayed on content cards in the UI.
      - `summary` string, nullable — Short summary of the book.
      - `image-url` string, nullable — Cover image of the book.
      - `obsolete` boolean — If the book should be marked as obsolete.
      - `publish-date` string, date-time, nullable — Date that the book was published.
      - `language` string, nullable — Language of the book.
      - `i-s-b-n-13` string, nullable — ISBN13 number of the book.
      - `url` string — URL location where more information can be found.
      - `format` string, nullable — The format of the book. 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

- Book
  - `data` BookData
    - `type` string
    - `id` string
    - `attributes` BookDataAttributes
      - `title` string — The title of the book.
      - `subtitle` string, nullable — The subtitle of the book.
      - `authors` string, nullable — Comma delimited list of authors.
      - `pages` integer, nullable — Number of pages.
      - `learning-minutes` integer — The calculated value that corresponds with the learning minutes displayed on content cards in the UI. For example, 1 page in a book is equal to 1 learning minute.
      - `summary` string, nullable — Short summary of the book.
      - `image-url` string, nullable — Cover image of the book.
      - `obsolete` boolean — If the book should be marked as obsolete.
      - `publish-date` string, date-time, nullable — Date that the book was published. (UTC)
      - `language` string, nullable — Language of the book.
      - `degreed-url` string, nullable — URL location of the book within Degreed UI.
      - `owner-id` string — The unique ID of the group or user that owns the content.
      - `owner-type` string — Must be either "user" or "group".
      - `i-s-b-n-13` string, nullable — ISBN13 number of the book.
      - `created-at` string, date-time — Date that the book was created. (UTC)
      - `modified-at` string, date-time — Date that the book was last modified. (UTC)
      - `provider-code` string, nullable — Unique provider code.
      - `url` string, nullable — URL location where more information can be found.
      - `external-id` string — External ID of the book. This is usually the URL where the book can be found.
      - `is-internal` boolean — 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.
      - `format` string, nullable — The format of the book. Possible values include `Electronic`, `Audio`, `Print`, or `Summary`.
      - `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)
