RedRover Logo

Content Tools

Preview a Bulk Schedule

Checks and prices up to 50 posts and comments at once, without scheduling anything.

POST/content/batches/preview
Scope: posts:writeAI Connector Tool: redrover_preview_content_batch

Every item gets its own list of errors, so you can fix them all in one go. Once every item is valid and the workspace has the credits, the response carries a confirmToken.

Schedule the batch with Confirm a Bulk Schedule, sending the same items and that token within 30 minutes.

A batch with comments in it also needs the comments:write scope.

Headers

  • AuthorizationstringRequired

    Bearer followed by an rr_live_ API key or a connected app's access token. See Authentication.

  • X-Workspace-IdstringRequired

    The workspace to act on, from List Workspaces.

    UUID

Body

  • itemsobject or object[]Required

    Up to 50 posts and comments. Each is the body you'd send to Schedule a Post or Schedule a Comment, plus type: post or comment

    1 to 50 items

Response

200 Each item's verdict, the total credits and, when the batch is good, a confirm token.

  • dataobjectRequired
    Show 6 Child Fields
    • itemsobject[]Required
      Show 6 Child Fields
      • indexintegerRequired

        Position in the items you sent, from 0

      • typestringRequired

        post or comment. Null when the type itself is missing

        one of post, comment · nullable

      • okbooleanRequired

        True when the item can be scheduled as sent

      • errorsstring[]Required

        What to fix before this item can be scheduled

      • creditsintegerRequired

        Credits this item will take once scheduled

      • scheduledFordatetimeRequired

        When it would go live, when the time is valid

        nullable

    • okbooleanRequired

      True when every item is valid and the credits cover the batch

    • totalCreditsintegerRequired

      Credits the whole batch will take

    • creditShortfallobjectRequired

      Set when the workspace doesn't have enough credits

      nullable

      Show 2 Child Fields
      • neededintegerRequired
      • availableintegerRequired
    • confirmTokenstringRequired

      Pass this with the same items to confirm. Null until every item is valid

      nullable

    • expiresAtdatetimeRequired

      When the confirm token stops working

      nullable

Errors

Every error uses the error envelope.

  • 400items is missing, empty, or longer than 50
  • 401The Authorization header is missing, or the key is invalid or revoked
  • 403The key lacks the endpoint's scope, or cannot reach the workspace
  • 429More than 120 requests in a minute. Wait for Retry-After seconds
  • 500Something went wrong on our side
curl -X POST "https://app.tryredrover.com/api/public/v1/content/batches/preview" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "X-Workspace-Id: $REDROVER_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "items": [
    {
      "type": "post",
      "title": "What we learned shipping a weekly changelog for a year",
      "body": "We started writing a public changelog every Friday. Here is what changed for us...",
      "subreddit": "startups",
      "scheduledFor": "2026-12-01T15:00:00Z"
    },
    {
      "type": "comment",
      "threadUrl": "https://www.reddit.com/r/startups/comments/1abcde2/how_do_you_plan_content/",
      "body": "We batch ours on Thursdays and ship Friday morning. Keeps it honest.",
      "scheduledFor": "2026-12-01T15:00:00Z"
    }
  ]
}'
200 Response
{
  "data": {
    "items": [
      {
        "index": 0,
        "type": "post",
        "ok": true,
        "errors": [],
        "credits": 32,
        "scheduledFor": "2026-12-01T15:00:00.000Z"
      },
      {
        "index": 1,
        "type": "comment",
        "ok": true,
        "errors": [],
        "credits": 8,
        "scheduledFor": "2026-12-01T15:00:00.000Z"
      }
    ],
    "ok": true,
    "totalCredits": 40,
    "creditShortfall": null,
    "confirmToken": "eyJ2IjoxLCJoIjoiNGYyYSIsImV4cCI6MTc2NDYwMTIwMDAwMH0",
    "expiresAt": "2026-11-30T15:30:00.000Z"
  }
}