RedRover Logo

Review Notes

Add a Post Review Note

Leaves a note on a post waiting for approval, asking our team for a change.

POST/posts/{id}/review-notes
Scope: posts:writeAI Connector Tool: redrover_add_review_note

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 ID (UUID) of a post waiting for approval

Body

  • bodystringRequired

    The note, up to 5,000 characters

    1 to 5000 characters

Response

201 The new note.

  • dataobjectRequired
    Show 8 Child Fields
    • idstringRequired

      Note ID (UUID)

    • onReplybooleanRequired

      True when the note is on a reply under the post, not the post itself

    • replyTostringRequired

      The note this one answers, for our team's replies

      nullable

    • bodystringRequired

      The note

    • createdAtstringRequired

      ISO 8601 datetime

    • resolvedbooleanRequired

      Whether the note is resolved

    • resolvedAtstringRequired

      ISO 8601 datetime

      nullable

    • resolvedBystringRequired

      Who resolved it

      nullable

Errors

Every error uses the error envelope.

  • 400body is missing or too long
  • 404No post with this ID in the workspace
  • 409The post is not waiting for approval, so it has no review notes
  • 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/posts/3c9a1f2e-7b4d-4e8a-9f61-2d5c8b7a0e14/review-notes" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "X-Workspace-Id: $REDROVER_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "body": "Can we make the title shorter?"
}'
201 Response
{
  "data": {
    "id": "b2e4c6a8-1d3f-4a5b-8c7d-9e0f1a2b3c4d",
    "onReply": false,
    "replyTo": null,
    "body": "Can we make the title shorter?",
    "createdAt": "2026-11-14T10:02:00Z",
    "resolved": false,
    "resolvedAt": null,
    "resolvedBy": null
  }
}