Update Token

Update your stored Reddit credentials. At least one of `bearer`, `session`, or `proxy` is required. • `session` — replaces any stored session, derives a fresh

PUT /api/v1/vault/update

Update your stored Reddit credentials. At least one of bearer, session, or proxy is required.

• session — replaces any stored session, derives a fresh bearer, and enables auto-refresh. Takes precedence over bearer if both are sent. If no proxy is supplied, the existing proxy on your token device is used.

• bearer — replaces the stored bearer with a manually-provided one. Any previously stored session is cleared so auto-refresh does not overwrite your bearer.

• proxy — updates the proxy on your token device. If the new external IP differs from the IP the bearer/session was created on, Reddit will invalidate them. NOTE: if you already have a session stored, changing only the proxy is rejected — submit a fresh session together with the new proxy in the same call.

Query parameters

Name	Type	Required	Description
`session`	string	No	Replacement `reddit_session` cookie JWT. Supersedes any currently stored session and the raw bearer. Enables auto-refresh.
`proxy`	string	No	New proxy in host:port:user:pass format.
`bearer`	string	No	Replacement bearer token. Ignored if `session` is also provided.

Authentication

Header	Value
`X-RapidAPI-Key`	Your RapidAPI key
`X-RapidAPI-Host`	`red-crawler1.p.rapidapi.com`

Example request

cURL

curl -X PUT "https://red-crawler1.p.rapidapi.com/api/v1/vault/update?session=<session>&proxy=<proxy>&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/v1/vault/update?session=<session>&proxy=<proxy>&bearer=<bearer>", {
  method: "PUT",
  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/v1/vault/update?session=<session>&proxy=<proxy>&bearer=<bearer>"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
}
resp = requests.put(url, headers=headers)
print(resp.json())

Example response

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

{
  "success": true,
  "data": {
    "token_hint": "...ZRhi",
    "expires_at": "2026-04-30T07:47:21.906002+00:00",
    "remaining": "13h 53m",
    "bearer_updated": true,
    "session_cleared": true,
    "proxy": "139.55.17.24:8888",
    "old_proxy": "126.122.43.123:8888",
    "proxy_updated": true,
    "updated": true
  },
  "error": null,
  "timestamp": "2026-04-29T17:54:11.529734+00:00"
}