Flair Management V2

Manage flairs mutations. Requires moderator bearer token. Three actions available: • clear_post — Remove flair from a post. Needs: post_id • clear_user — Remove

POST /api/v2/flairs/manage

Manage flairs mutations. Requires moderator bearer token. Three actions available: • clear_post — Remove flair from a post. Needs: post_id • clear_user — Remove a user's flair in your subreddit. Needs: subreddit, username • update_user — Set a user's flair using a template ID (get IDs from Flairs V2 endpoint). Needs: subreddit, username, flair_template_id Accepts subreddit name/URL/r/name. Accepts username/u/name/profile URL. Auto-resolves subreddit and user IDs.

Query parameters

Name	Type	Required	Description
`action`	string	Yes	Action: clear_post, clear_user, or update_user
`username`	string	No	Username, u/name, or profile URL — for clear_user and update_user actions
`post_id`	string	No	Post ID (t3_xxx, URL, or raw ID) — for clear_post action
`flair_template_id`	string	No	Flair template UUID from Flairs V2 endpoint — for update_user action
`proxy`	string	No	Your proxy as ip:port:user:pass. Skip if stored in Token Vault.
`subreddit`	string	No	Subreddit name/URL/r/name — for clear_user and update_user actions
`bearer`	string	No	Your Reddit bearer token. Skip if stored in Token Vault.

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/flairs/manage?action=clear_post&username=Motor_Tip8865&post_id=1sys4r2&flair_template_id=<flair_template_id>&proxy=<proxy>&subreddit=test&bearer=<bearer>" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com"

JavaScript

const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v2/flairs/manage?action=clear_post&username=Motor_Tip8865&post_id=1sys4r2&flair_template_id=<flair_template_id>&proxy=<proxy>&subreddit=test&bearer=<bearer>", {
  method: "POST",
  headers: {
      "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
    }
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://red-crawler1.p.rapidapi.com/api/v2/flairs/manage?action=clear_post&username=Motor_Tip8865&post_id=1sys4r2&flair_template_id=<flair_template_id>&proxy=<proxy>&subreddit=test&bearer=<bearer>"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
}
resp = requests.post(url, headers=headers)
print(resp.json())

Example response

HTTP 200 — captured from a live call to the gateway.

{
  "success": true,
  "data": {
    "success": true,
    "post_id": "t3_1sz24fg",
    "data": {
      "clearPostFlair": {
        "ok": true,
        "errors": null
      }
    }
  },
  "error": null,
  "meta": {
    "vault_expires_at": "2026-04-30T07:47:21.906002+00:00",
    "vault_remaining": "15h 31m"
  },
  "timestamp": "2026-04-29T16:15:32.770656+00:00"
}