Moderation V1
Modmail Bulk Read V1
Bulk mark modmail conversations as read for a subreddit.
POST /api/v1/moderate/modmail/bulk-read
Bulk mark modmail conversations as read for a subreddit.
Body parameters
| Name | Type | Required | Description |
|---|---|---|---|
entity | string | Yes | Subreddit fullname (t5_xxxxx). Must use t5_ format, NOT subreddit name. |
bearer | string | No | Bearer token. Optional if stored in Token Vault. |
proxy | string | No | Proxy. Optional if stored in Token Vault. |
state | string | No | Filter which conversations to mark read. Values: all, new, inprogress, mod, archived, appeals, join_requests, notifications, highlighted, filtered, default. |
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/v1/moderate/modmail/bulk-read" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com" \
-H "Content-Type: application/json" \
--data '{"entity": "<entity>", "bearer": "<bearer>", "proxy": "<proxy>", "state": "<state>"}'JavaScript
const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v1/moderate/modmail/bulk-read", {
method: "POST",
headers: {
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
},
body: JSON.stringify({
"entity": "<entity>",
"bearer": "<bearer>",
"proxy": "<proxy>",
"state": "<state>"
})
});
const data = await res.json();
console.log(data);Python
import requests
url = "https://red-crawler1.p.rapidapi.com/api/v1/moderate/modmail/bulk-read"
headers = {
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "red-crawler1.p.rapidapi.com",
"Content-Type": "application/json"
}
payload = {
"entity": "<entity>",
"bearer": "<bearer>",
"proxy": "<proxy>",
"state": "<state>"
}
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": {
"conversation_ids": []
},
"error": null,
"timestamp": "2026-04-29T15:33:18.482431+00:00"
}