---
title: "GET /assistants/{assistantId}/models"
method: GET
path: "/assistants/{assistantId}/models"
---

# GET /assistants/{assistantId}/models

`GET /assistants/{assistantId}/models`

Lists the models available to an Amazon Q in Connect assistant in the assistant's Amazon Web Services Region. The available models are determined by the region of the specified assistant.

## Path parameters

- `assistantId` string, required

## Query parameters

- `aiPromptType` 'ANSWER_GENERATION' | 'INTENT_LABELING_GENERATION' | 'QUERY_REFORMULATION' | 'SELF_SERVICE_PRE_PROCESSING' | 'SELF_SERVICE_ANSWER_GENERATION' | 'EMAIL_RESPONSE' | 'EMAIL_OVERVIEW' | 'EMAIL_GENERATIVE_ANSWER' | 'EMAIL_QUERY_REFORMULATION' | 'ORCHESTRATION' | 'NOTE_TAKING' | 'CASE_SUMMARIZATION'
- `modelLifecycle` 'ACTIVE' | 'LEGACY'
- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListModelsResponse
  - `modelSummaries` ModelSummary[], required — The summaries of the models available to the assistant.
    - `modelId` string, required — The identifier of the model.
    - `displayName` string, required — The display name of the model.
    - `crossRegionStatus` 'NONE' | 'REGIONAL' | 'GLOBAL' — The cross-region availability status of the model. <code>NONE</code> indicates the model is only available in a single region, <code>REGIONAL</code> indicates the model is available through regional inference, and <code>GLOBAL</code> indicates the model is available through global cross-region inference.
    - `supportsPromptCaching` boolean — Whether the model supports prompt caching.
    - `supportedAIPromptTypes` AIPromptType[] — The list of AI Prompt types that the model supports.
    - `modelLifecycle` 'ACTIVE' | 'LEGACY' — The current lifecycle of the model. <code>ACTIVE</code> indicates the model is recommended for use and <code>LEGACY</code> indicates the model is still usable but is deprecated.
    - `legacyTimestamp` string, date-time — The timestamp when the model lifecycle will transition from <code>ACTIVE</code> to <code>LEGACY</code>.
    - `endOfLifeTimestamp` string, date-time — The timestamp when the model will reach end of life and no longer be available for use.
  - `nextToken` string — If there are additional results, this is the token for the next set of results.

## Other responses

- `480` — ValidationException
- `481` — ConflictException
- `482` — UnauthorizedException
- `483` — AccessDeniedException
- `484` — ResourceNotFoundException
- `485` — ThrottlingException

---

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