RedRover Logo

Content Tools

Check Content

Runs our writing checks on one post or comment and returns what they flag. Fast, and uses no AI credits.

POST/content/check
Scope: workspace:readAI Connector Tool: redrover_check_content

Headers

  • AuthorizationstringRequired

    Bearer followed by an rr_live_ API key or a connected app's access token. See Authentication.

  • X-Workspace-Idstring

    The workspace to act on. Optional when the key can reach exactly one workspace.

    UUID

Body

  • typestringRequired

    post or comment

    one of post, comment

  • titlestring

    Post title. Required for posts, not allowed on comments

    1 to 300 characters

  • bodystringRequired

    The text: up to 40,000 characters for posts, 10,000 for comments

    1 to 40000 characters

  • subredditstring

    The subreddit it is meant for, which helps the checks

    1 to 50 characters

Response

200 What the checks found.

  • dataobjectRequired
    Show 2 Child Fields
    • passedbooleanRequired

      True when no check flagged anything

    • findingsobject[]Required
      Show 4 Child Fields
      • rulestringRequired

        The check that flagged it, like long-dash

      • fieldstringRequired

        one of title, body

      • messagestringRequired

        What to fix

      • spanobjectRequired

        Where in the field, when the check can point at it

        nullable

        Show 3 Child Fields
        • startnumberRequired
        • endnumberRequired
        • textstringRequired

Errors

Every error uses the error envelope.

  • 400The content is missing a field or too long
  • 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/content/check" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "X-Workspace-Id: $REDROVER_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "post",
  "title": "What we learned shipping a weekly changelog",
  "body": "We started writing a public changelog & it changed how we plan.",
  "subreddit": "startups"
}'
200 Response
{
  "data": {
    "passed": false,
    "findings": [
      {
        "rule": "ampersand",
        "field": "body",
        "message": "Write out and instead of using an ampersand",
        "span": {
          "start": 41,
          "end": 42,
          "text": "&"
        }
      }
    ]
  }
}