Mute a Chat User by Broadcast ID

Deprecated. POST /2/broadcasts/:id/chat/mutes prevents a user from posting in a broadcaster’s chat across all of their broadcasts. Use POST /2/broadcasts/chat/mutes instead.

POST /2/broadcasts/{id}/chat/mutes

Mute or Time Out a User in a Broadcast Chat

cURL

curl --request POST \
  --url https://api.x.com/2/broadcasts/{id}/chat/mutes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_id": "<string>",
  "end_at_ms": "<string>",
  "message_id": "<string>"
}
'

200

{
  "data": {
    "muted": true
  },
  "errors": [
    {
      "detail": "<string>",
      "resource_type": "<string>",
      "title": "<string>",
      "type": "https://api.x.com/2/problems/resource-not-found",
      "parameter": "<string>",
      "resource_id": "<string>",
      "status": 123,
      "value": "<string>"
    }
  ]
}

This route is deprecated. Use Mute a Chat User (POST /2/broadcasts/chat/mutes) instead.

Prevents a user from posting chat messages in the broadcaster’s chat. The mute applies to all of the broadcaster’s broadcasts, not only the broadcast identified by :id.

:id is the alphanumeric broadcast_id of a live broadcast. It only identifies whose chat you are moderating: the broadcast owner’s.

The authenticated user must be the broadcast owner or a chat moderator for the broadcast owner. When a moderator calls this endpoint, the mute applies to the chat of the owner they moderate for. See List Broadcast Moderators for how moderators are managed.

Pass an optional end_at_ms in the request body to time the mute out at a specific Unix timestamp in milliseconds. Omit end_at_ms to mute the user indefinitely.

Pass an optional message_id in the request body to remove a specific chat message at the same time. This is useful when muting is in response to a particular message.

To reverse this, use Unmute a Chat User. To see who the broadcaster has muted, use List Muted Chat Users. To remove an individual message without muting its author, use Delete a Chat Message.

Authorizations

OAuth2UserTokenUserToken

Authorization · string · header · required

The access token received from the authorization server in the OAuth 2.0 flow.

Scopes

broadcast.read

View your live broadcasts and their chat.

broadcast.write

Manage your live broadcasts and send chat messages on your behalf.

Path Parameters

id · string · required

Pattern: ^[a-zA-Z0-9]{1,24}$

Body

application/json

user_id · string · required

The user to mute.

Pattern: ^[1-9][0-9]{0,18}$

end_at_ms · string

The Unix timestamp in milliseconds when the mute expires. Omit this field to mute indefinitely.

Pattern: ^[1-9][0-9]{0,18}$

message_id · string

A chat message to remove while muting the user.

Pattern: ^[1-9][0-9]{0,18}$

Response

200

application/json

The request has succeeded.

data · object

Show child attributes

errors · object[]

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Option 11

Option 12

Option 13

Option 14

Option 15

Option 16

Option 17

Option 18

Option 19

Option 20

Option 21

Option 22

Option 23

Option 24

Option 25

Option 26

Option 27

Option 28

Option 29

Option 30

Option 31

Option 32

Option 33

Option 34

Option 35

Option 36

Option 37

Option 38

Option 39

Option 40

Option 41

Option 42

Option 43

Option 44

Option 45

Option 46

Option 47

Option 48

Option 49

Option 50

Option 51

Option 52

Option 53

Option 54

Option 55

Option 56

Option 57

Option 58

Option 59

Option 60

Option 61

Show child attributes