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

# POST /knowledgeBases/{knowledgeBaseId}/search

`POST /knowledgeBases/{knowledgeBaseId}/search`

Searches for content in a specified knowledge base. Can be used to get a specific content resource by its name.

## Path parameters

- `knowledgeBaseId` string, required

## Query parameters

- `nextToken` string
- `maxResults` integer

## Request body

- object
  - `searchExpression` object, required — The search expression.
    - `filters` Filter[] — The search expression filters.
      - `field` 'NAME', required — The field on which to filter.
      - `operator` 'EQUALS', required — The operator to use for comparing the field’s value with the provided value.
      - `value` string, required — The desired field value on which to filter.

## Response `200`

Success

- SearchContentResponse
  - `contentSummaries` ContentSummary[], required — Summary information about 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. This should not be a QUICK_RESPONSES type knowledge base.
    - `name` string, required — The name of the content.
    - `revisionId` string, required — The identifier of the revision of the content.
    - `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.
  - `nextToken` string — If there are additional results, this is the token for the next set of results.

## Other responses

- `480` — ValidationException
- `481` — UnauthorizedException
- `482` — AccessDeniedException
- `483` — 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)