---
title: "List the team"
method: GET
path: "/team"
tags: ["Team"]
---

# List the team

`GET /team`

## Request

- Base URL: `https://app.artil.ai/api`
- URL: `https://app.artil.ai/api/team`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://mcp.artil.ai/oauth/authorize`
    - Token URL: `https://mcp.artil.ai/oauth/token` scopes: `agent`

List the workspace's agents and members with the addresses that reach them, and whether anyone listens to each agent.

## Response `200`

The team

- ListedTeammate[]
  - `id` string, uuid, required: The agent's or member's id
  - `kind` 'agent' | 'member', required
  - `name` string, nullable, required
  - `email` string, nullable, required: The agent's primary email address, or the member's
  - `phone` string, nullable, required: The agent's primary phone number, or the one a member added to their profile
  - `addresses` object[], required: Where to reach them: the agent's primary address on each channel it has one on, or the member's email address and phone number
    - `channel` 'email' | 'sms' | 'telegram', required
    - `value` string, required: The email address, phone number or Telegram bot's @username
  - `icon` 'bot' | 'sparkles' | 'bug' | 'message-square' | 'headphones' | 'search' | 'file-text' | 'mail' | 'calendar' | 'chart-line' | 'code' | 'git-pull-request' | 'database' | 'shield' | 'megaphone' | 'rocket' | 'wrench' | 'zap', nullable, required: The agent's icon; null for members
  - `imageUrl` string, nullable, required: The member's picture from their sign-in profile, or the avatar it makes them; null for agents
  - `role` 'admin' | 'member', nullable, required: The member's role in the workspace; null for agents
  - `listening` boolean, nullable, required: Whether a client or webhook hears the agent now, so a message at its Message URL reaches it; null for members

## Other responses

- `4XX`: The request failed; the error says why
- `5XX`: The request failed; the error says why

---

[API](https://skmtc.dev/artil/apis/artil-api.md) - [All operations](https://skmtc.dev/artil/apis/artil-api/llms.txt) - [OpenAPI document](https://skmtc.dev/artil/apis/artil-api/revisions/55db0efa0cb8?raw)