---
title: "Get assistant"
method: GET
path: "/generative_ai/{assistant_id}"
tags: ["Assistants"]
---

# Get assistant

`GET /generative_ai/{assistant_id}`

Returns data of a specific assistant

## Path parameters

- `assistant_id` string, required

## Response `200`

successful

- GetAssistantExternal
  - `assistant` object
    - `_id` string
    - `name` string
    - `source` object
      - `sources` object[]
        - `_id` string
        - `name` string
    - `answer_formatting` object
      - `waiting_messages_for_analysis` string
      - `waiting_messages_for_search` string
      - `waiting_messages_for_answer_generation` string
    - `LLM` object
      - `provider` string
      - `name` string
      - `token` string
      - `max_tokens_to_generate` integer
      - `temperature` integer
      - `embeddings` string
      - `reuse_these_models` boolean
    - `query_condensation` object
      - `custom_instructions` string
      - `messages_to_condensate` integer
      - `chat_model` object
        - `name` string
        - `provider` string
        - `token` string
        - `max_tokens_to_generate` integer
        - `temperature` integer
        - `embeddings` string
    - `query_expansion` object
      - `custom_instructions` string
      - `messages_to_generate` integer
      - `llm_model` object
        - `name` string
        - `provider` string
        - `token` string
        - `max_tokens_to_generate` integer
        - `temperature` integer
        - `embeddings` string
    - `reranking` object
      - `algorithm` string
      - `llm_reranking_instructions` string
      - `llm_model` object
        - `name` string
        - `provider` string
        - `token` string
        - `max_tokens_to_generate` integer
        - `temperature` integer
        - `embeddings` string
    - `answer_generation` object
      - `instructions_choice` string
      - `main_instructions` string
      - `formatting_instructions` string
      - `maximum_answer_length` integer
      - `llm_model` object
        - `name` string
        - `provider` string
        - `token` string
        - `max_tokens_to_generate` integer
        - `temperature` integer
        - `embeddings` string
    - `company` object
      - `name` string
      - `contact_mail` string
      - `contact_page` string
      - `description` string
      - `location` string
      - `phone_number` string
      - `website` string
    - `dialog` object
      - `add_sources_to_answers` boolean
      - `chat_context_length` string
      - `custom_instructions` string
      - `instructions_source` string
      - `user_query_condensation_instructions` string
      - `query_generation_instructions` string
      - `answer_formatting_instructions` string
      - `tone_of_voice` string
      - `maximum_answer_length` integer
      - `use_llm_knowledge` boolean
    - `search` object
      - `number_best_results_llm_context` integer
      - `similarity_threshold` integer
    - `updatedAt` string
    - `createdAt` string
    - `user_id` string
    - `is_shared` boolean
    - `collaborators` string
    - `__v` integer

## Other responses

- `400` — Invalid ID supplied
- `404` — assistant not found

---

[API](https://skmtc.net/smartly/apis/smartly-ai-apis.md) · [All operations](https://skmtc.net/smartly/apis/smartly-ai-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartly/smartly-ai-apis/revisions/1e26909d86c9/schema)