---
title: "Get an assistant by ID"
method: GET
path: "/v1/Assistants/{id}"
---

# Get an assistant by ID

`GET /v1/Assistants/{id}`

## Request

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

get an assistant

## Path parameters

- `id` string, required

## Response `200`

OK

- AssistantsV1ServiceAssistantWithToolsAndKnowledge
  - `account_sid` string, required: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Assistant resource.
  - `customer_ai` object, required: The Personalization and Perception Engine settings.
  - `id` string, required: The Assistant ID.
  - `model` string, required: The default model used by the assistant.
  - `name` string, required: The name of the assistant.
  - `owner` string, required: The owner/company of the assistant.
  - `url` string: The url of the assistant resource.
  - `personality_prompt` string, required: The personality prompt to be used for assistant.
  - `date_created` string, date-time, required: The date and time in GMT when the Assistant 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 Assistant was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `knowledge` AssistantsV1ServiceKnowledge[], required: The list of knowledge sources associated with the assistant.
    - `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.
  - `tools` AssistantsV1ServiceTool[], required: The list of tools associated with the assistant.
    - `account_sid` string: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Tool resource.
    - `description` string, required: The description of the tool.
    - `enabled` boolean, required: True if the tool is enabled.
    - `id` string, required: The tool ID.
    - `meta` object, required: The metadata related to method, url, input_schema to used with the Tool.
    - `name` string, required: The name of the tool.
    - `requires_auth` boolean, required: The authentication requirement for the tool.
    - `type` string, required: The type of the tool. ('WEBHOOK')
    - `url` string: The url of the tool resource.
    - `date_created` string, date-time, required: The date and time in GMT when the Tool 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 Tool was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.

## Changes

- **2026-04-14** (v1) `bd3fb6f26e74`: 1 breaking, 13 info
  - the response's body type changed from no type to `object` for status `200`
  - removed `#/components/schemas/assistants.v1.service.assistant, subschema #2` from the response body `allOf` list for the response status `200`
  - added the optional property `url` to the response with the `200` status
  - added the required property `account_sid` to the response with the `200` status
  - …10 more
- **2025-05-13** (v1) `0852198458a0`: 3 info
  - the `allOf[#/components/schemas/assistants.v1.service.assistant]/id` response's property pattern was changed from `^aia_asst_*$` to `^aia_asst_.+$` for the status `200`
  - the `allOf[subschema #2]/knowledge/items/id` response's property pattern was changed from `^aia_know_*$` to `^aia_know_.+$` for the status `200`
  - the `allOf[subschema #2]/tools/items/id` response's property pattern was changed from `^aia_tool_*$` to `^aia_tool_.+$` for the status `200`
- **2025-01-09** (v1) `82c51662c266`: 6 info
  - added the optional property `allOf[subschema #2]/knowledge/items/embedding_model` to the response with the `200` status
  - the response property `allOf[subschema #2]/knowledge/items/date_created` became required for the status `200`
  - the response property `allOf[subschema #2]/knowledge/items/date_updated` became required for the status `200`
  - the response property `allOf[subschema #2]/knowledge/items/id` became required for the status `200`
  - …2 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/twilio/apis/assistants-v1/changes/v1/Assistants/:id/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)