---
title: "Retrieve an agent"
method: GET
path: "/rest/api/v1/agents/{agent_id}"
tags: ["Agents"]
---

# Retrieve an agent

`GET /rest/api/v1/agents/{agent_id}`

Returns details of an [agent](https://developers.glean.com/agents/agents-api) created in the Agent Builder.

## Path parameters

- `agent_id` string, required — The ID of the agent.

## Query parameters

- `locale` string
- `timezoneOffset` integer

## Headers

- `X-Glean-ActAs` string, email
- `X-Glean-Auth-Type` string

## Response `200`

Success

- Agent
  - `agent_id` string, required — The ID of the agent.
  - `name` string, required — The name of the agent
  - `description` string — The description of the agent.
  - `metadata` object — The agent metadata. Currently not implemented.
  - `capabilities` object, required — Describes features that the agent supports. example: { "ap.io.messages": true, "ap.io.streaming": true }
    - `ap.io.messages` boolean — Whether the agent supports messages as an input. If true, you'll pass `messages` as an input when running the agent.
    - `ap.io.streaming` boolean — Whether the agent supports streaming output. If true, you you can stream agent ouput. All agents currently support streaming.

## Other responses

- `400` — Bad request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal server error

---

[API](https://skmtc.net/gleanwork/apis/glean-client-api.md) · [All operations](https://skmtc.net/gleanwork/apis/glean-client-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gleanwork/glean-client-api/versions/98678e54a6c5/schema)