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

# POST /knowledgeBases/{knowledgeBaseId}/quickResponses

`POST /knowledgeBases/{knowledgeBaseId}/quickResponses`

Creates a Wisdom quick response.

## Path parameters

- `knowledgeBaseId` string, required

## Request body

- object
  - `channels` Channel[] — The Amazon Connect channels this quick response applies to.
  - `clientToken` string — A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see <a href="https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/">Making retries safe with idempotent APIs</a>.
  - `content` object, required — The container of quick response data.
    - `content` string, password — The content of the quick response.
  - `contentType` string — <p>The media type of the quick response content.</p> <ul> <li> <p>Use <code>application/x.quickresponse;format=plain</code> for a quick response written in plain text.</p> </li> <li> <p>Use <code>application/x.quickresponse;format=markdown</code> for a quick response written in richtext.</p> </li> </ul>
  - `description` string — The description of the quick response.
  - `groupingConfiguration` object — The configuration information of the grouping of Wisdom users.
    - `criteria` string, password — <p>The criteria used for grouping Wisdom users.</p> <p>The following is the list of supported criteria values.</p> <ul> <li> <p> <code>RoutingProfileArn</code>: Grouping the users by their <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_RoutingProfile.html">Amazon Connect routing profile ARN</a>. User should have <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchRoutingProfiles.html">SearchRoutingProfile</a> and <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeRoutingProfile.html">DescribeRoutingProfile</a> permissions when setting criteria to this value.</p> </li> </ul>
    - `values` GroupingValue[] — <p>The list of values that define different groups of Wisdom users.</p> <ul> <li> <p>When setting <code>criteria</code> to <code>RoutingProfileArn</code>, you need to provide a list of ARNs of <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_RoutingProfile.html">Amazon Connect routing profiles</a> as values of this parameter.</p> </li> </ul>
  - `isActive` boolean — Whether the quick response is active.
  - `language` string — The language code value for the language in which the quick response is written. The supported language codes include <code>de_DE</code>, <code>en_US</code>, <code>es_ES</code>, <code>fr_FR</code>, <code>id_ID</code>, <code>it_IT</code>, <code>ja_JP</code>, <code>ko_KR</code>, <code>pt_BR</code>, <code>zh_CN</code>, <code>zh_TW</code>
  - `name` string, required — The name of the quick response.
  - `shortcutKey` string — The shortcut key of the quick response. The value should be unique across the knowledge base.
  - `tags` object — The tags used to organize, track, or control access for this resource.

## Response `200`

Success

- CreateQuickResponseResponse
  - `quickResponse` object — The quick response.
    - `channels` Channel[] — The Amazon Connect contact channels this quick response applies to. The supported contact channel types include <code>Chat</code>.
    - `contentType` string, required — <p>The media type of the quick response content.</p> <ul> <li> <p>Use <code>application/x.quickresponse;format=plain</code> for quick response written in plain text.</p> </li> <li> <p>Use <code>application/x.quickresponse;format=markdown</code> for quick response written in richtext.</p> </li> </ul>
    - `contents` object — The contents of the quick response.
      - `markdown` QuickResponseContentProvider — The container quick response content.
        - `content` string, password — The content of the quick response.
      - `plainText` QuickResponseContentProvider — The container quick response content.
        - `content` string, password — The content of the quick response.
    - `createdTime` string, date-time, required — The timestamp when the quick response was created.
    - `description` string — The description of the quick response.
    - `groupingConfiguration` object — The configuration information of the user groups that the quick response is accessible to.
      - `criteria` string, password — <p>The criteria used for grouping Wisdom users.</p> <p>The following is the list of supported criteria values.</p> <ul> <li> <p> <code>RoutingProfileArn</code>: Grouping the users by their <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_RoutingProfile.html">Amazon Connect routing profile ARN</a>. User should have <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchRoutingProfiles.html">SearchRoutingProfile</a> and <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeRoutingProfile.html">DescribeRoutingProfile</a> permissions when setting criteria to this value.</p> </li> </ul>
      - `values` GroupingValue[] — <p>The list of values that define different groups of Wisdom users.</p> <ul> <li> <p>When setting <code>criteria</code> to <code>RoutingProfileArn</code>, you need to provide a list of ARNs of <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_RoutingProfile.html">Amazon Connect routing profiles</a> as values of this parameter.</p> </li> </ul>
    - `isActive` boolean — Whether the quick response is active.
    - `knowledgeBaseArn` string, required — The Amazon Resource Name (ARN) of the knowledge base.
    - `knowledgeBaseId` string, required — The identifier of the knowledge base. This should not be a QUICK_RESPONSES type knowledge base if you're storing Wisdom Content resource to it. Can be either the ID or the ARN. URLs cannot contain the ARN.
    - `language` string — The language code value for the language in which the quick response is written.
    - `lastModifiedBy` string — The Amazon Resource Name (ARN) of the user who last updated the quick response data.
    - `lastModifiedTime` string, date-time, required — The timestamp when the quick response data was last modified.
    - `name` string, required — The name of the quick response.
    - `quickResponseArn` string, required — The Amazon Resource Name (ARN) of the quick response.
    - `quickResponseId` string, required — The identifier of the quick response.
    - `shortcutKey` string — The shortcut key of the quick response. The value should be unique across the knowledge base.
    - `status` 'CREATE_IN_PROGRESS' | 'CREATE_FAILED' | 'CREATED' | 'DELETE_IN_PROGRESS' | 'DELETE_FAILED' | 'DELETED' | 'UPDATE_IN_PROGRESS' | 'UPDATE_FAILED', required — The status of the quick response data.
    - `tags` object — The tags used to organize, track, or control access for this resource.

## Other responses

- `480` — ConflictException
- `481` — ValidationException
- `482` — ServiceQuotaExceededException
- `483` — AccessDeniedException
- `484` — ResourceNotFoundException

---

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