Moderation V2
Mute / Unmute User V2
Mute or unmute a user in a subreddit. Muted users cannot send modmail to the subreddit for the specified duration. Set `muted=true` (default) to mute, `muted=f
POST /api/v2/mod/user-mute
Mute or unmute a user in a subreddit. Muted users cannot send modmail to the subreddit for the specified duration.
Set muted=true (default) to mute, muted=false to unmute. Optional duration_days — must be 3, 7, or 28 (matches Reddit web UI). Omit for permanent mute.
NOTE: Reddit requires the target user to have a prior modmail conversation with the mod team. Without one, Reddit returns an upstream service error.
Body parameters
| Name | Type | Required | Description |
|---|---|---|---|
subreddit | string | Yes | Subreddit: name, r/name, URL, or t5_ ID. |
user | string | Yes | Reddit user: username, u/name, profile URL, or t2_ ID. |
bearer | string | No | Reddit bearer token. Auto-resolves from Token Vault. |
proxy | string | No | Proxy ip:port:user:pass. Auto-resolves from Token Vault. |
duration_days | number | No | Mute duration: 3, 7, or 28 days only. Omit for permanent mute. |
muted | boolean | No | true to mute (default), false to unmute. |
reason | string | No | Reason for the mute (visible to other mods). |
Authentication
| Header | Value |
|---|---|
X-RapidAPI-Key | Your RapidAPI key |
X-RapidAPI-Host | red-crawler1.p.rapidapi.com |
Example request
cURL
curl -X POST "https://red-crawler1.p.rapidapi.com/api/v2/mod/user-mute" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com" \
-H "Content-Type: application/json" \
--data '{"subreddit": "SpaceX_Starship_News", "user": "Motor_Tip8865", "bearer": "<bearer>", "proxy": "<proxy>", "duration_days": "1", "muted": "true", "reason": "<reason>"}'JavaScript
const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v2/mod/user-mute", {
method: "POST",
headers: {
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
},
body: JSON.stringify({
"subreddit": "SpaceX_Starship_News",
"user": "Motor_Tip8865",
"bearer": "<bearer>",
"proxy": "<proxy>",
"duration_days": "1",
"muted": "true",
"reason": "<reason>"
})
});
const data = await res.json();
console.log(data);Python
import requests
url = "https://red-crawler1.p.rapidapi.com/api/v2/mod/user-mute"
headers = {
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "red-crawler1.p.rapidapi.com",
"Content-Type": "application/json"
}
payload = {
"subreddit": "SpaceX_Starship_News",
"user": "Motor_Tip8865",
"bearer": "<bearer>",
"proxy": "<proxy>",
"duration_days": "1",
"muted": "true",
"reason": "<reason>"
}
resp = requests.post(url, headers=headers, json=payload)
print(resp.json())Example response
HTTP 200 — captured from a live call to the gateway.
{
"success": true,
"data": {
"ok": true,
"muted": true
},
"error": null,
"meta": {
"vault_expires_at": "2026-04-30T07:47:21.906002+00:00",
"vault_remaining": "15h 34m"
},
"timestamp": "2026-04-29T16:12:29.790801+00:00"
}