---
title: "List all knowledge for an Assistant"
method: GET
path: "/v1/Assistants/{assistantId}/Knowledge"
---

# List all knowledge for an Assistant

`GET /v1/Assistants/{assistantId}/Knowledge`

## Request

- Base URL: `https://assistants.twilio.com`
- URL: `https://assistants.twilio.com/v1/Assistants/{assistantId}/Knowledge`
- Auth: HTTP basic

List all knowledge for an Assistant

## Path parameters

- `assistantId` string, required

## Query parameters

- `Page` integer
- `PageSize` integer
- `PageToken` string

## Response `200`

OK

- object
  - `knowledge` AssistantsV1ServiceKnowledge[]
    - `description` string: The type of knowledge source.
    - `id` string, required: The description of knowledge.
    - `account_sid` string: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Knowledge resource.
    - `knowledge_source_details` object: The details of the knowledge source based on the type.
    - `name` string, required: The name of the knowledge source.
    - `status` string: The status of processing the knowledge source ('QUEUED', 'PROCESSING', 'COMPLETED', 'FAILED')
    - `type` string, required: The type of knowledge source ('Web', 'Database', 'Text', 'File')
    - `url` string: The url of the knowledge resource.
    - `embedding_model` string: The embedding model to be used for the knowledge source.
    - `date_created` string, date-time, required: The date and time in GMT when the Knowledge was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `date_updated` string, date-time, required: The date and time in GMT when the Knowledge was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

## Changes

- **2025-05-13** (v1) `0852198458a0`: 1 info
  - the `knowledge/items/id` response's property pattern was changed from `^aia_know_*$` to `^aia_know_.+$` for the status `200`
- **2025-01-09** (v1) `82c51662c266`: 6 info
  - added the optional property `knowledge/items/embedding_model` to the response with the `200` status
  - the response property `knowledge/items/date_created` became required for the status `200`
  - the response property `knowledge/items/date_updated` became required for the status `200`
  - the response property `knowledge/items/id` became required for the status `200`
  - …2 more
- **2024-09-25** (v1) `1ad87f675d4b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/twilio/apis/assistants-v1/changes/v1/Assistants/:assistantId/Knowledge/get.md)

---

[API](https://skmtc.dev/twilio/apis/assistants-v1.md) - [All operations](https://skmtc.dev/twilio/apis/assistants-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/assistants-v1/revisions/c5ec7f024ee9?raw)
