# List who can open the dashboard

`GET https://api.tryscouty.com/v1/team`

Lists the people who can sign in to this brand's dashboard, as the team panel on the Workspace page shows them: each address, when it was added, and which one is you.

- Scope: `team:manage`
- Kind: read
- MCP tool: `scouty_list_team`

## Authorization

Send `Authorization: Bearer $SCOUTY_TOKEN`. The token needs the `team:manage` scope.

## Details

`scouty_list_team` shows what the team panel on the Workspace page shows. It needs `team:manage`, which is off unless someone ticked it.

```json
{
  "members": [
    { "email": "maya@glow.example", "addedAt": "2026-08-02T10:14:00.000Z", "isYou": true },
    { "email": "sam@glow.example", "addedAt": "2026-09-11T16:40:00.000Z", "isYou": false }
  ]
}
```

## Request

### cURL

```bash
curl -s https://api.tryscouty.com/v1/team \
  -H "Authorization: Bearer $SCOUTY_TOKEN"
```

### JavaScript

```js
const response = await fetch("https://api.tryscouty.com/v1/team", {
  headers: {
    Authorization: `Bearer ${process.env.SCOUTY_TOKEN}`,
  },
});
console.log(await response.json());
```

### Python

```python
import os

import requests

token = os.environ["SCOUTY_TOKEN"]
response = requests.get(
    "https://api.tryscouty.com/v1/team",
    headers={"Authorization": f"Bearer {token}"},
)
print(response.json())
```

## Responses

### 200 OK

```json
{
  "members": [
    {
      "email": "maya@acme.example",
      "addedAt": "2026-08-02T10:14:00.000Z",
      "isYou": true
    },
    {
      "email": "sam@acme.example",
      "addedAt": "2026-09-11T16:40:00.000Z",
      "isYou": false
    }
  ]
}
```

### 401 Unauthorized

```json
{
  "error": {
    "code": "missing_token",
    "message": "This API needs an Authorization header carrying a bearer token."
  }
}
```

### 403 Forbidden

```json
{
  "error": {
    "code": "insufficient_scope",
    "message": "This token does not carry the team:manage scope. Ask the team for one that does."
  }
}
```

### 429 Too Many Requests

```json
{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Please wait for the current minute to end."
  }
}
```

## Errors

| Status | `error.code` | Meaning |
|---|---|---|
| 401 Unauthorized | `missing_token`, `invalid_token`, `token_revoked`, `token_expired`, `token_orphaned` | No token, or one that is not recognized, revoked or expired. |
| 403 Forbidden | `insufficient_scope`, `wrong_principal` | The token does not carry the scope this capability needs. |
| 429 Too Many Requests | `rate_limited` | Too many requests this minute. Retry-After says how long is left. |

Full reference: https://docs.tryscouty.com/reference