Edit Scheduled Image V2

Edit a pending scheduled image post. Only pending posts can be edited. All fields except 'id' are optional — only provided fields are updated.

PUT /api/v2/schedule/image

Edit a pending scheduled image post. Only pending posts can be edited. All fields except 'id' are optional — only provided fields are updated.

Body parameters

Name	Type	Required	Description
`id`	string	Yes	Scheduled post ID (from create or list response)
`spoiler`	string	No	Mark as spoiler (true/false)
`brand_affiliate`	string	No	Mark as brand affiliate / commercial (true/false)
`subreddit`	string	No	New target subreddit (optional)
`body`	string	No	New post body / markdown (optional)
`bearer`	string	No	Bearer token. Optional if stored in Token Vault.
`flair_id`	string	No	Flair template ID
`flair_text`	string	No	Flair text
`proxy`	string	No	Proxy. Optional if stored in Token Vault.
`publish_at`	string	No	New publish time (ISO-8601 UTC, optional)
`image_url`	string	No	New image URL
`title`	string	No	New post title (optional)
`delete_after`	string	No	Auto-delete post after N seconds
`nsfw`	string	No	Mark as NSFW (true/false)

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/v2/schedule/image" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com" \
  -H "Content-Type: application/json" \
  --data '{"id": "<id>", "spoiler": "<spoiler>", "brand_affiliate": "<brand_affiliate>", "subreddit": "test", "body": "<body>", "bearer": "<bearer>", "flair_id": "<flair_id>", "flair_text": "<flair_text>", "proxy": "<proxy>", "publish_at": "<publish_at>", "image_url": "<image_url>", "title": "<title>", "delete_after": "<delete_after>", "nsfw": "<nsfw>"}'

JavaScript

const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v2/schedule/image", {
  method: "PUT",
  headers: {
      "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
    },
    body: JSON.stringify({
  "id": "<id>",
  "spoiler": "<spoiler>",
  "brand_affiliate": "<brand_affiliate>",
  "subreddit": "test",
  "body": "<body>",
  "bearer": "<bearer>",
  "flair_id": "<flair_id>",
  "flair_text": "<flair_text>",
  "proxy": "<proxy>",
  "publish_at": "<publish_at>",
  "image_url": "<image_url>",
  "title": "<title>",
  "delete_after": "<delete_after>",
  "nsfw": "<nsfw>"
})
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://red-crawler1.p.rapidapi.com/api/v2/schedule/image"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com",
    "Content-Type": "application/json"
}
payload = {
  "id": "<id>",
  "spoiler": "<spoiler>",
  "brand_affiliate": "<brand_affiliate>",
  "subreddit": "test",
  "body": "<body>",
  "bearer": "<bearer>",
  "flair_id": "<flair_id>",
  "flair_text": "<flair_text>",
  "proxy": "<proxy>",
  "publish_at": "<publish_at>",
  "image_url": "<image_url>",
  "title": "<title>",
  "delete_after": "<delete_after>",
  "nsfw": "<nsfw>"
}
resp = requests.put(url, headers=headers, json=payload)
print(resp.json())

Example response

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

{
  "success": true,
  "data": {
    "updated": true,
    "id": 119,
    "subreddit": "RedCrawlerAPI",
    "parent_id": "",
    "title": "Schedule Image Post V2",
    "type": "image",
    "publish_at": "2026-05-01T10:00:00+00:00",
    "delete_after": 1440,
    "delete_at": "2026-05-01T10:24:00+00:00",
    "status": "pending"
  },
  "error": null,
  "timestamp": "2026-04-29T17:36:25.544384+00:00"
}