Flairs V1
Flair Config V1
Configure subreddit-wide flair settings: enable/disable user and post flairs, set positions, and self-assign permissions. Requires mod permissions.
POST /api/v1/communities/{name}/flair-config
Configure subreddit-wide flair settings: enable/disable user and post flairs, set positions, and self-assign permissions. Requires mod permissions.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Subreddit name. |
Body parameters
| Name | Type | Required | Description |
|---|---|---|---|
flair_self_assign_enabled | string | No | Allow users to self-assign flair. true or false. |
flair_position | string | No | User flair position: left or right. |
link_flair_position | string | No | Post flair position: empty (disabled), left, or right. |
proxy | string | No | Proxy. Optional if stored in Token Vault. |
bearer | string | No | Bearer token. Optional if stored in Token Vault. |
flair_enabled | string | No | Enable user flair. true or false. |
link_flair_self_assign_enabled | string | No | Allow users to self-assign post flair. true or false. |
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/communities/pcmasterrace/flair-config" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com" \
-H "Content-Type: application/json" \
--data '{"flair_self_assign_enabled": "false", "flair_position": "right", "link_flair_position": "left", "proxy": "<proxy>", "bearer": "<bearer>", "flair_enabled": "true", "link_flair_self_assign_enabled": "false"}'JavaScript
const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v1/communities/pcmasterrace/flair-config", {
method: "POST",
headers: {
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
},
body: JSON.stringify({
"flair_self_assign_enabled": "false",
"flair_position": "right",
"link_flair_position": "left",
"proxy": "<proxy>",
"bearer": "<bearer>",
"flair_enabled": "true",
"link_flair_self_assign_enabled": "false"
})
});
const data = await res.json();
console.log(data);Python
import requests
url = "https://red-crawler1.p.rapidapi.com/api/v1/communities/pcmasterrace/flair-config"
headers = {
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "red-crawler1.p.rapidapi.com",
"Content-Type": "application/json"
}
payload = {
"flair_self_assign_enabled": "false",
"flair_position": "right",
"link_flair_position": "left",
"proxy": "<proxy>",
"bearer": "<bearer>",
"flair_enabled": "true",
"link_flair_self_assign_enabled": "false"
}
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": {
"json": {
"errors": []
}
},
"error": null,
"timestamp": "2026-04-29T10:35:41.259934+00:00"
}Flair CSV V1
Bulk-set user flairs via CSV format. Up to 100 lines, each line: username,flair_text,css_class. Requires mod permissions.
Set User Flair V1
Set or clear a user's flair in a subreddit. Two modes: - **Template-based**: Provide `flair_template_id` (and optional `text` override). Uses Reddit's `/api/se