---
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}`

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.
  - `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

---

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