---
title: "Get Assistant By ID"
method: GET
path: "/agent/{agent_id}"
tags: ["agent"]
---

# Get Assistant By ID

`GET /agent/{agent_id}`

Retrieves detailed information about a specific assistant by its ID.

## Path parameters

- `agent_id` string, required

## Headers

- `X-API-KEY` string, required

## Response `200`

Successful Response: Detailed information about the assistant.

- object
  - `agents` object
    - `id` string
    - `agent_display_name` string
    - `agent_type` string
    - `whitelisted_domains` string[]
    - `language` string
    - `form_fields` object[]
      - `key` string
      - `value` string
    - `voice` object
      - `id` string
      - `name` string
      - `voice_preview` string, uri
    - `agent_config` object
    - `knowledge_base_id` string, nullable
    - `knowledge_base_name` string, nullable
    - `template_name` string
    - `template_label` string
    - `template_icon` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `tools` object[]
      - `name` string
      - `config` object
      - `tool_type` string
    - `secondary_language` string, nullable
    - `secondary_voice_id` string, nullable
    - `template_type` string

## Other responses

- `401` — Unauthorized - Invalid or missing API key.
- `404` — Not Found - Resource doesn't exist.
- `500` — Internal Server Error - Something went wrong on our end.

---

[API](https://skmtc.net/ringg/apis/ringg-ai-api-documentation.md) · [All operations](https://skmtc.net/ringg/apis/ringg-ai-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringg/ringg-ai-api-documentation/versions/00b614a7714c/schema)