TeleLive Docs

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`).