---
title: "GET /assistants"
method: GET
path: "/assistants"
---

# GET /assistants

`GET /assistants`

Lists information about assistants.

## Query parameters

- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListAssistantsResponse
  - `assistantSummaries` AssistantSummary[], required — Information about the assistants.
    - `assistantArn` string, required — The Amazon Resource Name (ARN) of the Wisdom assistant.
    - `assistantId` string, required — The identifier of the Wisdom assistant.
    - `description` string — The description of the assistant.
    - `integrationConfiguration` object — The configuration information for the Wisdom assistant integration.
      - `topicIntegrationArn` string — The Amazon Resource Name (ARN) of the integrated Amazon SNS topic used for streaming chat messages.
    - `name` string, required — The name of the assistant.
    - `serverSideEncryptionConfiguration` object — <p>The configuration information for the customer managed key used for encryption. </p> <p>This KMS key must have a policy that allows <code>kms:CreateGrant</code>, <code>kms:DescribeKey</code>, and <code>kms:Decrypt/kms:GenerateDataKey</code> permissions to the IAM identity using the key to invoke Wisdom. To use Wisdom with chat, the key policy must also allow <code>kms:Decrypt</code>, <code>kms:GenerateDataKey*</code>, and <code>kms:DescribeKey</code> permissions to the <code>connect.amazonaws.com</code> service principal. </p> <p>For more information about setting up a customer managed key for Wisdom, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/enable-wisdom.html">Enable Amazon Connect Wisdom for your instance</a>.</p>
      - `kmsKeyId` string — The customer managed key used for encryption. For more information about setting up a customer managed key for Wisdom, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/enable-wisdom.html">Enable Amazon Connect Wisdom for your instance</a>. For information about valid ID values, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id">Key identifiers (KeyId)</a>.
    - `status` 'CREATE_IN_PROGRESS' | 'CREATE_FAILED' | 'ACTIVE' | 'DELETE_IN_PROGRESS' | 'DELETE_FAILED' | 'DELETED', required — The status of the assistant.
    - `tags` object — The tags used to organize, track, or control access for this resource.
    - `type` 'AGENT', required — The type of the assistant.
  - `nextToken` string — If there are additional results, this is the token for the next set of results.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException

---

[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)