RedRover Logo

Review Batches

Approve a Review Batch

Approves the whole batch, or only the items you list and their comments. Approved content goes on the schedule.

POST/review-batches/{id}/approve
Scope: posts:writeAI Connector Tool: redrover_approve_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

Body

  • itemIdsstring[]

    Approve only these items and their comments. Leave out to approve the whole batch

    1 to 500 items · UUID

Response

200 What was approved and the batch's status.

  • dataobjectRequired
    Show 2 Child Fields
    • approvedItemIdsstring[]Required

      Items approved by this call

      UUID

    • batchStatusstringRequired

      The batch's status afterwards

      one of open, approved

Errors

Every error uses the error envelope.

  • 400An item ID is not in this batch
  • 404No review batch with this ID in the workspace
  • 409The batch is being rewritten, or changed while you were approving it
  • 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/review-batches/8d0f6a52-3c1e-4b7a-9e2f-5a6b7c8d9e01/approve" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "X-Workspace-Id: $REDROVER_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "itemIds": [
    "3f1e2d3c-4b5a-4968-8776-655443322110"
  ]
}'
200 Response
{
  "data": {
    "approvedItemIds": [
      "3f1e2d3c-4b5a-4968-8776-655443322110"
    ],
    "batchStatus": "open"
  }
}