---
title: "Get agent details"
method: GET
path: "/agents/{agent_id}"
tags: ["Agents"]
---

# Get agent details

`GET /agents/{agent_id}`

Retrieve detailed information for a specific agent.

    Returns complete agent configuration including:
    - Agent ID and name
    - Agent type (inbound/outbound) and active status
    - AI provider and selected voice details
    - Prompt instructions and first message settings
    - Language configuration (default and supported languages)
    - Verified caller ID (for outbound agents)
    - Created/updated timestamps

    The agent must belong to your organization. Attempting to access an agent
    from another organization will return 404.

    Authentication:
    - API key with READ or READ_WRITE permission, or
    - OAuth access token granted the `agents:read` scope

## Path parameters

- `agent_id` string, uuid, required

## Response `200`

Successfully retrieved agent details

- object
  - `ok` boolean
  - `data` object
    - `id` string, uuid
    - `organization_id` string, uuid
    - `name` string
    - `agent_type` string
    - `agent_type_display_name` string
    - `is_active` boolean
    - `ai_provider` string, nullable
    - `ai_provider_display_name` string, nullable
    - `first_message` string, nullable
    - `disable_first_message_interruptions` boolean
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401` — Invalid or missing API key
- `403` — Insufficient permissions
- `404` — Resource not found

---

[API](https://skmtc.net/yourang/apis/yourang-ai-external-api-v1.md) · [All operations](https://skmtc.net/yourang/apis/yourang-ai-external-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yourang/yourang-ai-external-api-v1/versions/49680ee64400/schema)