Content Tools
Preview a Bulk Schedule
Checks and prices up to 50 posts and comments at once, without scheduling anything.
https://app.tryredrover.com/api/public/v1/content/batches/previewposts:writeAI Connector Tool: redrover_preview_content_batchEvery 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
AuthorizationstringRequiredBearerfollowed by anrr_live_API key or a connected app's access token. See Authentication.X-Workspace-IdstringRequiredThe workspace to act on, from List Workspaces.
UUID
Body
itemsobject or object[]RequiredUp to 50 posts and comments. Each is the body you'd send to Schedule a Post or Schedule a Comment, plus
type:postorcomment1 to 50 items
Response
200 Each item's verdict, the total credits and, when the batch is good, a confirm token.
dataobjectRequiredShow 6 Child FieldsHide Child Fields
itemsobject[]RequiredShow 6 Child FieldsHide Child Fields
indexintegerRequiredPosition in the items you sent, from 0
typestringRequiredpost or comment. Null when the type itself is missing
one of post, comment · nullable
okbooleanRequiredTrue when the item can be scheduled as sent
errorsstring[]RequiredWhat to fix before this item can be scheduled
creditsintegerRequiredCredits this item will take once scheduled
scheduledFordatetimeRequiredWhen it would go live, when the time is valid
nullable
okbooleanRequiredTrue when every item is valid and the credits cover the batch
totalCreditsintegerRequiredCredits the whole batch will take
creditShortfallobjectRequiredSet when the workspace doesn't have enough credits
nullable
Show 2 Child FieldsHide Child Fields
neededintegerRequiredavailableintegerRequired
confirmTokenstringRequiredPass this with the same items to confirm. Null until every item is valid
nullable
expiresAtdatetimeRequiredWhen the confirm token stops working
nullable
Errors
Every error uses the error envelope.
400items is missing, empty, or longer than 50401The Authorization header is missing, or the key is invalid or revoked403The key lacks the endpoint's scope, or cannot reach the workspace429More than 120 requests in a minute. Wait for Retry-After seconds500Something 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"
}
]
}'{
"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"
}
}