---
title: "GetAgent"
method: POST
path: "/gitpod.v1.AgentService/GetAgent"
tags: ["gitpod.v1.AgentService"]
---

# GetAgent

`POST /gitpod.v1.AgentService/GetAgent`

Gets details about a specific agent including description,
 and required models.

 Use this method to:
 - Check if an agent is defined correctly
 - Understand which models are required for this agent

 ### Examples

 - Get agent details:

   ```yaml
   agentId: "07e03a28-65a5-4d98-b532-8ea67b188048"
   ```

## Request body

- GitpodV1GetAgentRequest
  - `agentId` string, uuid

## Response `200`

Success

- GitpodV1GetAgentResponse — unresolved $ref

## Other responses

- `default` — Error

## Changes

> 18 revisions in range; 1 could not be searched.

- **2026-04-02** `dabc0ff98cd7` — 1 breaking, 9 warning, 4 info
  - added `subschema #1, subschema #2, subschema #3` to the `agent/inEnvironment/service/runsOn` response property `oneOf` list for the response status `200`
  - added the new `SUPPORTED_MODEL_HAIKU_4_5` enum value to the `agent/inEnvironment/requiredModels/items/` response property for the response status `200`
  - added the new `SUPPORTED_MODEL_HAIKU_4_5` enum value to the `agent/runnerSide/prompts/items/model` response property for the response status `200`
  - added the new `SUPPORTED_MODEL_HAIKU_4_5` enum value to the `agent/spec/prompts/items/model` response property for the response status `200`
  - …10 more
- **2026-02-11** `b97dcde84128` — 6 warning
  - added the new `SUPPORTED_MODEL_OPUS_4_6` enum value to the `agent/inEnvironment/requiredModels/items/` response property for the response status `200`
  - added the new `SUPPORTED_MODEL_OPUS_4_6` enum value to the `agent/runnerSide/prompts/items/model` response property for the response status `200`
  - added the new `SUPPORTED_MODEL_OPUS_4_6` enum value to the `agent/spec/prompts/items/model` response property for the response status `200`
  - added the new `SUPPORTED_MODEL_OPUS_4_6_EXTENDED` enum value to the `agent/inEnvironment/requiredModels/items/` response property for the response status `200`
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/gitpod-io/apis/gitpod-v1/changes/gitpod.v1.AgentService/GetAgent/post.md)

---

[API](https://skmtc.dev/gitpod-io/apis/gitpod-v1.md) · [All operations](https://skmtc.dev/gitpod-io/apis/gitpod-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gitpod-io/gitpod-v1/revisions/44d50c2ac284/schema)