---
title: "List the AI agents (MCP clients) that can act for this workspace."
method: GET
path: "/v1/workspaces/{workspaceId}/agents"
---

# List the AI agents (MCP clients) that can act for this workspace.

`GET /v1/workspaces/{workspaceId}/agents`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/agents`
- Auth: HTTP bearer

## Response `200`

Active agent connections, newest first.

- object
  - `data` object[], required
    - `id` string, uuid, required
    - `client_name` string, required
    - `client_surface` 'codex' | 'chatgpt' | 'claude' | 'grok' | 'gemini' | 'other_agent', required: The agent platform behind an OAuth connection, from the client's name and redirect URIs.
    - `scopes` string[], required
    - `connected_at` string, date-time, required
    - `last_active_at` string, date-time, required
    - `connected_by_you` boolean, required

---

[API](https://skmtc.dev/bangermail/apis/banger-api.md) · [All operations](https://skmtc.dev/bangermail/apis/banger-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bangermail/apis/banger-api/revisions/a149909267f9?raw)