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

# Get Agent details

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

## Request

- Base URL: `https://api.svahnar.com`
- URL: `https://api.svahnar.com/v1/agents/get-agent/{agent_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/svahnar/apis/svahnar-apis/docs/v1/agents/get-agent/:agent_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve detailed information about a specific agent by its ID. The user must have access to the agent (via personal agents or team membership).

## Path parameters

- `agent_id` string, required: The unique identifier of the agent.

## Response `200`

Successful Response

- AgentDetailWithYamlNote: Agent detail returned by the get-agent endpoint, includes a note about YAML config.
  - `agent_id` string, required: Unique identifier of the agent.
  - `name` string, required: Name of the agent.
  - `description` string, required: Description of the agent.
  - `agent_icon` string, nullable: Presigned S3 URL of the agent icon.
  - `is_creator` boolean, required: Whether the requesting user is the creator of this agent.
  - `hosted_to` string, required: Deployment target: 'AgentStore' or 'Organization'.
  - `uploaded_by` UploadedByInfo, required: Information about the user who uploaded / created the agent.
    - `user_id` string, nullable: ID of the user who created the agent.
    - `user_email` string, nullable: Email of the user who created the agent.
  - `request_metadata` ResponseMeta
    - `request_id` string, nullable: Unique request identifier for tracing and support.
  - `yaml_configuration` string, required: A note directing the user to the download endpoint for the YAML configuration.

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-04** `a39db90c150d`: 1 info
  - added the optional property `agent_icon` to the response with the `200` status
- **2026-02-11** `c9a09aaa6236`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/svahnar/apis/svahnar-apis.md) - [All operations](https://skmtc.dev/svahnar/apis/svahnar-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/svahnar/apis/svahnar-apis/revisions/a39db90c150d?raw)