RedRover Logo

Review Batches

Get a Review Batch

Returns one review batch with every post and comment, how many notes are open on each, and the batch feedback.

GET/review-batches/{id}
Scope: posts:readAI Connector Tool: redrover_get_review_batch

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

Path Parameters

  • idstringRequired

    The review batch ID from List Review Batches

Response

200 The batch.

  • dataobjectRequired
    Show 8 Child Fields
    • idstringRequired

      Review batch ID

      UUID

    • namestringRequired

      The batch's name

    • monthstringRequired

      The month the batch is for, YYYY-MM-DD

    • statusstringRequired

      open while it is being reviewed, approved once signed off

      one of open, approved

    • approvedAtdatetimeRequired

      When it was approved

      nullable

    • createdAtdatetimeRequired

      When it was created

    • itemsobject[]Required

      Every post and comment, posts first with their comments after

      Show 9 Child Fields
      • idstringRequired

        Item ID

        UUID

      • kindstringRequired

        post or comment

        one of post, comment

      • parentIdstringRequired

        For a comment, the item it replies to

        UUID · nullable

      • titlestringRequired

        Post title. Null for comments

        nullable

      • bodystringRequired

        The text

      • subredditstringRequired

        Subreddit, without r/

        nullable

      • flairstringRequired

        Post flair

        nullable

      • statusstringRequired

        pending, approved, or approvedWithChanges (approved once the requested edits are made)

        one of pending, approved, approvedWithChanges

      • openNotesintegerRequired

        Review notes on this item that are not resolved yet

    • feedbackobject[]Required

      Feedback on the batch as a whole, oldest first

      Show 4 Child Fields
      • idstringRequired

        Feedback ID

        UUID

      • bodystringRequired

        The feedback

      • createdAtdatetimeRequired

        When it was left

      • resolvedbooleanRequired

        True once our team has addressed it

Errors

Every error uses the error envelope.

  • 404No review batch with this ID in the workspace
  • 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 "https://app.tryredrover.com/api/public/v1/review-batches/8d0f6a52-3c1e-4b7a-9e2f-5a6b7c8d9e01" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "X-Workspace-Id: $REDROVER_WORKSPACE_ID"
200 Response
{
  "data": {
    "id": "8d0f6a52-3c1e-4b7a-9e2f-5a6b7c8d9e01",
    "name": "December Content",
    "month": "2026-12-01",
    "status": "open",
    "approvedAt": null,
    "createdAt": "2026-11-20T15:00:00Z",
    "items": [
      {
        "id": "3f1e2d3c-4b5a-4968-8776-655443322110",
        "kind": "post",
        "parentId": null,
        "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",
        "flair": null,
        "status": "pending",
        "openNotes": 1
      }
    ],
    "feedback": [
      {
        "id": "9e8d7c6b-5a49-4382-9170-6f5e4d3c2b1a",
        "body": "Lean more on the pricing angle this month.",
        "createdAt": "2026-11-21T10:00:00Z",
        "resolved": false
      }
    ]
  }
}