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

# Get an assistant by ID

`GET /v1/Assistants/{id}`

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.

---

[API](https://skmtc.net/twilio/apis/assistants-v1.md) · [All operations](https://skmtc.net/twilio/apis/assistants-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/assistants-v1/versions/c5ec7f024ee9/schema)