Moderation
List moderators
GET /public/v1/moderation/moderators?broadcaster_user_id=123
Requires `moderation:read` (or `channel:read`) on a channel you own or moderate.
## Ban / timeout
POST /public/v1/moderation/bans
Authorization: Bearer tloa_…
Content-Type: application/json
{
"broadcaster_user_id": 123,
"user_id": 333,
"duration": 10,
"reason": "spam"
}
| Field | Notes |
|-------|--------|
| `broadcaster_user_id` | Required |
| `user_id` | Target user |
| `duration` | Minutes (1–10080) = timeout. **Omit** for a permanent ban. |
| `reason` | Optional, max 100 chars |
Scope: **`moderation:ban`**
## Unban / remove timeout
DELETE /public/v1/moderation/bans
Content-Type: application/json
{
"broadcaster_user_id": 123,
"user_id": 333
}
Scope: **`moderation:ban`**
## Webhook
Event name: `moderation.banned` (subscribe on the Developer page). Payload includes `broadcaster`, `moderator`, `banned_user`, and `metadata` (`reason`, `created_at`, `expires_at`).