---
title: "POST /knowledgeBases/{knowledgeBaseId}/contents/{contentId}"
method: POST
path: "/knowledgeBases/{knowledgeBaseId}/contents/{contentId}"
---

# POST /knowledgeBases/{knowledgeBaseId}/contents/{contentId}

`POST /knowledgeBases/{knowledgeBaseId}/contents/{contentId}`

Updates information about the content.

## Path parameters

- `knowledgeBaseId` string, required
- `contentId` string, required

## Request body

- object
  - `revisionId` string — The <code>revisionId</code> of the content resource to update, taken from an earlier call to <code>GetContent</code>, <code>GetContentSummary</code>, <code>SearchContent</code>, or <code>ListContents</code>. If included, this argument acts as an optimistic lock to ensure content was not modified since it was last read. If it has been modified, this API throws a <code>PreconditionFailedException</code>.
  - `title` string — The title of the content.
  - `overrideLinkOutUri` string — The URI for the article. If the knowledge base has a templateUri, setting this argument overrides it for this piece of content. To remove an existing <code>overrideLinkOurUri</code>, exclude this argument and set <code>removeOverrideLinkOutUri</code> to true.
  - `removeOverrideLinkOutUri` boolean — Unset the existing <code>overrideLinkOutUri</code> if it exists.
  - `metadata` object — A key/value map to store attributes without affecting tagging or recommendations. For example, when synchronizing data between an external system and Amazon Q in Connect, you can store an external version identifier as metadata to utilize for determining drift.
  - `uploadId` string — A pointer to the uploaded asset. This value is returned by <a href="https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_StartContentUpload.html">StartContentUpload</a>.

## Response `200`

Success

- UpdateContentResponse
  - `content` object — The content.
    - `contentArn` string, required — The Amazon Resource Name (ARN) of the content.
    - `contentId` string, required — The identifier of the content.
    - `knowledgeBaseArn` string, required — The Amazon Resource Name (ARN) of the knowledge base.
    - `knowledgeBaseId` string, required — The identifier of the knowledge base.
    - `name` string, required — The name of the content.
    - `revisionId` string, required — The identifier of the content revision.
    - `title` string, required — The title of the content.
    - `contentType` string, required — The media type of the content.
    - `status` 'CREATE_IN_PROGRESS' | 'CREATE_FAILED' | 'ACTIVE' | 'DELETE_IN_PROGRESS' | 'DELETE_FAILED' | 'DELETED' | 'UPDATE_FAILED', required — The status of the content.
    - `metadata` object, required — A key/value map to store attributes without affecting tagging or recommendations. For example, when synchronizing data between an external system and Amazon Q in Connect, you can store an external version identifier as metadata to utilize for determining drift.
    - `tags` object — The tags used to organize, track, or control access for this resource.
    - `linkOutUri` string — The URI of the content.
    - `url` string, password, required — The URL of the content.
    - `urlExpiry` string, date-time, required — The expiration time of the URL as an epoch timestamp.

## Other responses

- `480` — ValidationException
- `481` — UnauthorizedException
- `482` — AccessDeniedException
- `483` — PreconditionFailedException
- `484` — ResourceNotFoundException

---

[API](https://skmtc.net/aws/apis/qconnect.md) · [All operations](https://skmtc.net/aws/apis/qconnect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/qconnect/versions/833f5de92023/schema)