# List agents

`GET /v1/agents`

Returns the members of your workspace who can be assigned chats, by name, and whether each is available now.

Needs `chats:write`.

## What is returned

Email addresses are never included. The list isn't paged, so `next_cursor` is always `null`.

## Example

```sh
curl https://app.soosh.io/v1/agents \
  -H "Authorization: Bearer $SOOSH_API_KEY"
```

Response 200:

```json
{
  "data": [
    {
      "id": "5b1d7d0e-3c2a-4f61-9a0e-6f8f3b2c1d40",
      "name": "Anita Menon",
      "available": true
    },
    {
      "id": "1b3d5f7b-9c1e-4a3c-b5e7-9d1f3b5d7f8a",
      "name": "Ravi Kumar",
      "available": false
    }
  ],
  "next_cursor": null
}
```

## Returns

200. The agents.