RedRover Logo

Review Batches

Reset a Review Link

Replaces the batch's review link with a new one. Every earlier link stops working, including any our team sent.

POST/review-batches/{id}/share-link
Scope: posts:writeAI Connector Tool: redrover_reset_review_link

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 new review link.

  • dataobjectRequired
    Show 2 Child Fields
    • batchIdstringRequired

      Review batch ID

      UUID

    • urlstringRequired

      The review page. Anyone with this link can read the batch and leave notes, without signing in

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 -X POST "https://app.tryredrover.com/api/public/v1/review-batches/8d0f6a52-3c1e-4b7a-9e2f-5a6b7c8d9e01/share-link" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "X-Workspace-Id: $REDROVER_WORKSPACE_ID"
200 Response
{
  "data": {
    "batchId": "8d0f6a52-3c1e-4b7a-9e2f-5a6b7c8d9e01",
    "url": "https://app.tryredrover.com/share/review/8d0f6a52-3c1e-4b7a-9e2f-5a6b7c8d9e01?token=Qm9vc3RjYW1wUmV2aWV3TGluaw"
  }
}