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

## 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

## Changes

> 92 revisions in range; 12 could not be searched.

- **2026-07-21** `972a5118199e` — 1 info
  - the endpoint scheme security `APIToken` was added to the API
- **2026-07-21** `2d62172604d1` — 1 info
  - the endpoint scheme security `APIToken` was removed from the API
- **2026-06-22** `08c17c9175d0` — 1 info
  - the endpoint scheme security `APIToken` was added to the API
- **2026-06-21** `b162fb37b3ad` — 1 info
  - the endpoint scheme security `APIToken` was removed from the API
- **2026-06-20** `d1f1d35ae0f9` — 1 info
  - the endpoint scheme security `APIToken` was added to the API

[Full history](https://skmtc.dev/gleanwork/apis/glean-api/changes/rest/api/v1/agents/:agent_id/get.md)

---

[API](https://skmtc.dev/gleanwork/apis/glean-api.md) · [All operations](https://skmtc.dev/gleanwork/apis/glean-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gleanwork/glean-api/revisions/7ed1f79f6fb7/schema)