---
title: "Update an existing content item."
method: PUT
path: "/authoring/v1/content/{id}"
tags: ["Authoring content"]
---

# Update an existing content item.

`PUT /authoring/v1/content/{id}`

Use the /content/{id} end point to update an existing content item. You must retrieve the content item first by using the GET endpoint before you can update. This endpoint requires the full representation of the content item to update it. If there is a need to preview and/or review changes to the item prior to the update going live, first use the /content/{id}/create-draft endpoint to create a draft of the item and perform the update on the draft version. Following this, the draft may then be readied via the /content/{id}/ready endpoint to finalize the update. However, if there is no need to preview and/or review the update, then the update can be directly performed on an item with "ready" status.
<br />User roles: admin, manager, editor

## Path parameters

- `id` string, required

## Query parameters

- `include` string
- `fields` string
- `forceOverride` boolean

## Headers

- `x-ibm-dx-publish-priority` 'now' | 'next', string

## Request body

- object
  - `rev` string — The current revision of the document.
  - `typeId` string — The ID of the content type this content item is based on.

## Response `200`

Successfully updated the content item that matches the ID that you provided.

- object
  - `id` string — The ID of the content item.
  - `rev` string — The current revision of the document.
  - `name` string — The name of the content item.
  - `description` string — The description of the content item.
  - `typeId` string — The ID of the content type this item belongs to.
  - `type` string — The name of the content type this item belongs to. Only included when using include=metadata
  - `kind` string — The kind of the content. Recognized values are "site", "page", "landing-page", "email"
  - `lastModified` string, date-time — The last modified date of this content item in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ. This field is read only.
  - `lastModifierId` string — The ID of the user that last modified the content.
  - `lastModifier` string — The display name of the user that last modified the content.
  - `created` string, date-time — The created date of this content item in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ. This field is read only.
  - `creatorId` string — The ID of the creator of the content.
  - `creator` string — The display name of the user that created the content.
  - `classification` 'content' — The classification defines the document type. For content items, all documents are classified as "content".
  - `status` 'draft' | 'ready' | 'retired' — the workflow status of the content.
  - `linkedDocId` string — Provided on drafts of existing items. This is the ID of the primary item.
  - `elements` object — The elements section is dependent on the content type of this content. (Referenced via the typeId attribute) with Elements are defined in the content type and therefore the elements section is dependent on the content type of this content. The content type is referenced through the typeId attribute. A content can have multiple elements such as text, number, video, images etc. For a complete list of content elements see, https://developer.goacoustic.com/acoustic-content/reference#authoring-content
  - `tags` string[] — The tags describing the content item.
  - `links` object
    - `self` object — The default link back to this document
      - `href` string
    - `linkedDoc` object — This link will appear if this item is a draft of an existing item. The link points to the primary item
      - `href` string
    - `draft` object — This link will appear on an item if there exists a draft of this item. The link points to the draft.
      - `href` string
    - `create-draft` object — This link will appear for items in ready and retired state that don't already have an existing draft. It will create a draft of this item.
      - `href` string
    - `ready` object — This link will appear for items that can be transitioned to the ready state.
      - `href` string
    - `retire` object — This link will appear for items that can be transitioned to the retired state.
      - `href` string
    - `type` object — This is the link to the content's type.
      - `href` string
  - `thumbnail` object — The reference to the resource that should act as the thumbnail of this content item. The thumbnail can be referred to by either id or path. This field is read only, and is determined by the contentThumbnail field on the content type. The type can specify an image element on this content item, or a specific image resource.
    - `id` string — The ID of the asset.
    - `path` string — The path of the resource.
    - `url` string — The url of the resource.
  - `isSystem` boolean — Indicates whether this item is a 'system item' or not. 'System item' means that this is an item managed internally by Acoustic.
  - `libraryId` string — If this property is set it points to library id that the item is assigned to.

## Other responses

- `400` — The update request is invalid or the request failed validation.
- `404` — The content item with ID {id} was not found.
- `409` — Unable to update the content item with the ID {id} because another user updated the content item since it was last retrieved. Retrieve the content item again and reapply your changes.
- `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time.
- `503` — Unable to retrieve the content item from the database as the service is unavailable. Try again later.
- `default` — Unexpected error.

---

[API](https://skmtc.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/versions/677305266d89/schema)