# Take someone's access to the dashboard away

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

Removes an email address from this brand's dashboard, as the team panel does. Their agent tokens stop working with it. You cannot remove yourself, or the last person on the team.

- Scope: `team:manage`
- Kind: write
- Safe to retry with the same idempotency key: yes
- MCP tool: `scouty_remove_team_member`

## Authorization

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

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `Idempotency-Key` | `string` | Optional | The same key the body's idempotencyKey carries. Send one or the other, or both with the same value. |

## Body parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `idempotencyKey` | `string` | Required | A key you choose for this call, 8 to 128 characters of letters, digits, dot, underscore, colon or hyphen. Sending the same key with the same arguments replays the first answer and changes nothing, so a retry after a timeout is safe. |
| `email` | `string` | Required | The person's email address. It is the Google account they sign in with. |

## Details

`scouty_remove_team_member` takes an email address off your dashboard. Any agent token that person made stops working. You cannot remove yourself (the person whose token is calling), or the last person on the team.

```json
{ "status": "removed" }
```

## Request

### cURL

```bash
curl -s -X DELETE https://api.tryscouty.com/v1/team \
  -H "Authorization: Bearer $SCOUTY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"idempotencyKey":"team-remove-sam-1","email":"sam@acme.example"}'
```

### JavaScript

```js
const response = await fetch("https://api.tryscouty.com/v1/team", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.SCOUTY_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    idempotencyKey: "team-remove-sam-1",
    email: "sam@acme.example"
  }),
});
console.log(await response.json());
```

### Python

```python
import os

import requests

token = os.environ["SCOUTY_TOKEN"]
response = requests.delete(
    "https://api.tryscouty.com/v1/team",
    headers={"Authorization": f"Bearer {token}"},
    json={
        "idempotencyKey": "team-remove-sam-1",
        "email": "sam@acme.example",
    },
)
print(response.json())
```

## Responses

### 200 OK

```json
{
  "status": "removed"
}
```

### 400 Bad Request

```json
{
  "error": {
    "code": "invalid_request",
    "message": "Those arguments are not the shape this capability takes: idempotencyKey."
  }
}
```

### 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."
  }
}
```

### 409 Conflict

```json
{
  "error": {
    "code": "idempotency_conflict",
    "message": "That idempotency key was already used for a different request. Use a new key."
  }
}
```

### 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 |
|---|---|---|
| 400 Bad Request | `invalid_request` | The request was not the shape this capability takes, or its body was not JSON. |
| 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. |
| 409 Conflict | `idempotency_conflict` | That idempotency key was already used for a different request. Nothing was changed. |
| 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