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

# Get Agent

`GET /v1/agent/agents/{agent_id}`

## Request

- Base URL: `https://api.fish.audio`
- URL: `https://api.fish.audio/v1/agent/agents/{agent_id}`
- Auth: HTTP bearer

Fetch one agent's profile fields. The draft configuration lives at
`GET /v1/agent/agents/{agent_id}/config`.

## Path parameters

- `agent_id` string, required

## Response `200`

Request fulfilled, document follows

- object
  - `agent_id` string, required
  - `workspace_id` string, required
  - `name` string, required
  - `description` string
  - `status` 'active' | 'archived', required
  - `publication_state` 'live' | 'draft', required: `live` once at least one version is published; `draft` agents cannot take sessions yet.
  - `public_enabled` boolean
  - `allowed_origins` string[]
  - `overrides_allowed` string[]
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `401`: No permission -- see authorization schemes
- `404`: Nothing matches the given URI
- `503`: The server cannot process the request due to a high load

## Changes

- **2026-11-03** `42ac421f7a12`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fish/apis/fishaudio-openapi/changes/v1/agent/agents/:agent_id/get.md)

---

[API](https://skmtc.dev/fish/apis/fishaudio-openapi.md) - [All operations](https://skmtc.dev/fish/apis/fishaudio-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/fish/apis/fishaudio-openapi/revisions/42ac421f7a12?raw)