---
title: "List available agents"
method: GET
path: "/api/v1/ai/workspaces/{workspace_id}/agents"
tags: ["Agents"]
---

# List available agents

`GET /api/v1/ai/workspaces/{workspace_id}/agents`

## Request

- Base URL: `https://www.gooddata.ai`
- URL: `https://www.gooddata.ai/api/v1/ai/workspaces/{workspace_id}/agents`
- Auth: none declared

List agents the user can use in this workspace, sorted A-Z.

This is the personalized "usable here" view for the agent switcher --
access-filtered to the user, enabled, non-preview, with per-agent
lastUsedAt. For agent CRUD/management use the metadata entity endpoint
GET /api/v1/entities/agents instead.

## Path parameters

- `workspace_id` string, required

## Response `200`

Successful Response

- AgentListResponse: List of agents accessible to the calling user.
  - `agents` AgentListItemResponse[], required
    - `description` string
    - `id` string, required
    - `isAvailableToAll` boolean, required
    - `lastUsedAt` string, date-time
    - `modifiedAt` string, date-time
    - `name` string, required
    - `skills` SkillName[]: Names of the skills this agent can use in this workspace, as listed by GET /api/v1/ai/agent/skills.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/revisions/c728ef303bfb?raw)