RedRover Logo

Core Concepts

Scopes

Scopes decide what a key can do. Give each key only the ones it needs.

Each endpoint needs one scope, shown at the top of its reference page. A key without it gets 403 forbidden with the missing scope named in the message. Pick scopes when you create a key; to change them, create a new key and revoke the old one.

ScopeAllowsEndpoints
workspace:readRead the workspace profile, company information and banned subreddits, and run content checksGet Workspace Profile, Get Credits, Get Company Information, List Document Versions, List Banned Subreddits, Check Content
workspace:writeChange the workspace profile and rewrite contentUpdate Workspace Profile, Rewrite Content
posts:readList and read posts and their review notesList Posts, Get Post, List Post Review Notes, List Review Batches, Get a Review Batch, Get a Review Link, List a Client's Posts
posts:writeSchedule, edit, approve and cancel posts, and leave review notes on themSchedule a Post, Edit or Reschedule a Post, Approve a Post, Cancel a Post, Add a Post Review Note, Resolve Post Review Notes, Approve a Review Batch, Leave Batch Feedback, Reset a Review Link, Schedule a Post for a Client, Preview a Bulk Schedule, Confirm a Bulk Schedule
comments:readList and read comments and their review notesList Comments, Get Comment, List Comment Review Notes, List a Client's Comments
comments:writeSchedule, edit, approve and cancel comments, and leave review notes on themSchedule a Comment, Edit or Reschedule a Comment, Approve a Comment, Cancel a Comment, Add a Comment Review Note, Resolve Comment Review Notes, Schedule a Comment for a Client
analytics:readRead Reddit results and AI search visibilityGet Reddit Performance, Get AI Search Visibility
knowledge:writeUpdate company information and ban or unban subredditsUpdate Company Information, Ban or Unban a Subreddit
keywords:readList keywords and target promptsList Keywords, List Target Prompts
keywords:writeAdd and retire target promptsAdd Target Prompts, Retire a Target Prompt
webhooks:readList webhook endpoints and their recent deliveriesList Webhook Endpoints, Get a Webhook Endpoint, List Webhook Deliveries, List Agency Webhooks, Get an Agency Webhook, List Agency Webhook Deliveries
webhooks:writeCreate, change and delete webhook endpoints, and send test eventsCreate a Webhook Endpoint, Update a Webhook Endpoint, Delete a Webhook Endpoint, Send a Test Event, Create an Agency Webhook, Update an Agency Webhook, Delete an Agency Webhook, Send a Test Event to an Agency Webhook
reports:readList and read weekly gameplans, weekly summaries and performance reportsList Reports, Get a Report
mentions:readList mentions of your brand on RedditList Mentions
notifications:readList recent activity on your content: status changes, new replies and removalsList Activity
strategy:readRead the campaign strategy and list blog campaignsGet the Campaign Strategy, List Blog Campaigns
clients:readPartner keys only. List and read your agency's clientsList Clients, Get a Client
clients:writePartner keys only. Add clients, change their name or reference, and invite a client loginAdd a Client, Update a Client
credits:readPartner keys only. Read your agency's credit balance and each client's capGet Agency Credits, Get a Client's Credits

List Workspaces needs no scope: any valid credential can see which workspaces it reaches.