# RedRover API > Schedule and manage Reddit content, read results and track AI search visibility. JSON over HTTPS at https://app.tryredrover.com/api/public/v1, authenticated with an rr_live_ API key or a connected AI app's OAuth token. ## Guides - [Introduction](https://docs.tryredrover.com): Schedule and manage Reddit content, read your results and track AI search visibility from your own code or AI app. - [Quickstart](https://docs.tryredrover.com/quickstart): Make your first request and schedule a post in about five minutes. - [Authentication](https://docs.tryredrover.com/authentication): Authenticate with an API key, or with the access token of an AI app a user connected. - [Workspaces](https://docs.tryredrover.com/workspaces): Every request acts on one workspace, picked with the X-Workspace-Id header. - [Scopes](https://docs.tryredrover.com/scopes): Scopes decide what a key can do. Give each key only the ones it needs. - [Scheduling](https://docs.tryredrover.com/scheduling): Schedule content at least 5 minutes ahead, and change it until 5 minutes before it goes live. - [Pagination](https://docs.tryredrover.com/pagination): List endpoints return pages. Walk them with limit and offset. - [Rate Limits](https://docs.tryredrover.com/rate-limits): Each key or connected user can make 120 requests a minute. - [Errors](https://docs.tryredrover.com/errors): Errors use standard HTTP statuses and one JSON envelope. - [Webhooks](https://docs.tryredrover.com/webhooks): Get a signed request the moment your content is scheduled, goes live, fails or needs your approval, instead of polling. - [Agency Partners](https://docs.tryredrover.com/partners): Partner keys, client keys, the sandbox and agency webhooks for agencies running many clients. - [AI Connector](https://docs.tryredrover.com/ai-connector): Connect Claude, ChatGPT, Cursor or any app that supports remote MCP servers, and manage RedRover in plain language. - [API Terms](https://docs.tryredrover.com/terms): The rules for using the RedRover API, API keys and the AI connector. ## Machine-Readable - [OpenAPI spec](https://docs.tryredrover.com/openapi.json) - [Every page as Markdown](https://docs.tryredrover.com/llms-full.txt) ## Workspaces - [List Workspaces](https://docs.tryredrover.com/reference/list-workspaces): GET /workspaces. Lists the workspaces your key or connected app can act on. This is the one endpoint that needs no X-Workspace-Id. - [Get Workspace Profile](https://docs.tryredrover.com/reference/get-workspace-profile): GET /workspace/profile. Reads the workspace's company profile: website, description, keywords, subreddits, competitors and brand names. - [Update Workspace Profile](https://docs.tryredrover.com/reference/update-workspace-profile): PATCH /workspace/profile. Changes the company profile. Send only the fields to change; lists replace the stored list. - [Get Credits](https://docs.tryredrover.com/reference/get-credits): GET /credits. Reads the workspace's credits: the balance, credits expiring soon, what posts and comments cost, 30 days of usage and a link to top up. ## Posts - [List Posts](https://docs.tryredrover.com/reference/list-posts): GET /posts. Lists the workspace's posts with their status. Content waiting for your approval comes first, then the rest by schedule, newest first. - [Get Post](https://docs.tryredrover.com/reference/get-post): GET /posts/{id}. Reads one post: its text, subreddit, status, schedule, live link and results once posted. - [Schedule a Post](https://docs.tryredrover.com/reference/create-post): POST /posts. Schedules a new post in a subreddit at least 5 minutes ahead. - [Edit or Reschedule a Post](https://docs.tryredrover.com/reference/update-post): PATCH /posts/{id}. Changes the text or timing of a post you can still change. Send only the fields to change. - [Approve a Post](https://docs.tryredrover.com/reference/approve-post): POST /posts/{id}/approve. Approves a post our team wrote and sent for your review. Approved content goes onto the schedule. - [Cancel a Post](https://docs.tryredrover.com/reference/cancel-post): DELETE /posts/{id}. Cancels a scheduled post before it goes live. The post stays in the list with status cancelled. ## Comments - [List Comments](https://docs.tryredrover.com/reference/list-comments): GET /comments. Lists the workspace's comments with their status. Content waiting for your approval comes first, then the rest by schedule, newest first. - [Get Comment](https://docs.tryredrover.com/reference/get-comment): GET /comments/{id}. Reads one comment: its text, subreddit, status, schedule, live link and results once posted. - [Schedule a Comment](https://docs.tryredrover.com/reference/create-comment): POST /comments. Schedules a comment on a Reddit thread at least 5 minutes ahead. - [Edit or Reschedule a Comment](https://docs.tryredrover.com/reference/update-comment): PATCH /comments/{id}. Changes the text or timing of a comment you can still change. Send only the fields to change. - [Approve a Comment](https://docs.tryredrover.com/reference/approve-comment): POST /comments/{id}/approve. Approves a comment our team wrote and sent for your review. Approved content goes onto the schedule. - [Cancel a Comment](https://docs.tryredrover.com/reference/cancel-comment): DELETE /comments/{id}. Cancels a scheduled comment before it goes live. The comment stays in the list with status cancelled. ## Review Notes - [List Post Review Notes](https://docs.tryredrover.com/reference/list-post-review-notes): GET /posts/{id}/review-notes. Lists the review notes on a post waiting for your approval, with our team's replies. - [Add a Post Review Note](https://docs.tryredrover.com/reference/add-post-review-note): POST /posts/{id}/review-notes. Leaves a note on a post waiting for approval, asking our team for a change. - [Resolve Post Review Notes](https://docs.tryredrover.com/reference/resolve-post-review-notes): PATCH /posts/{id}/review-notes. Marks review notes resolved, or reopens them. - [List Comment Review Notes](https://docs.tryredrover.com/reference/list-comment-review-notes): GET /comments/{id}/review-notes. Lists the review notes on a comment waiting for your approval, with our team's replies. - [Add a Comment Review Note](https://docs.tryredrover.com/reference/add-comment-review-note): POST /comments/{id}/review-notes. Leaves a note on a comment waiting for approval, asking our team for a change. - [Resolve Comment Review Notes](https://docs.tryredrover.com/reference/resolve-comment-review-notes): PATCH /comments/{id}/review-notes. Marks review notes resolved, or reopens them. ## Review Batches - [List Review Batches](https://docs.tryredrover.com/reference/list-review-batches): GET /review-batches. Lists the batches of posts and comments our team wrote for you to review, newest first. - [Get a Review Batch](https://docs.tryredrover.com/reference/get-review-batch): GET /review-batches/{id}. Returns one review batch with every post and comment, how many notes are open on each, and the batch feedback. - [Approve a Review Batch](https://docs.tryredrover.com/reference/approve-review-batch): POST /review-batches/{id}/approve. Approves the whole batch, or only the items you list and their comments. Approved content goes on the schedule. - [Leave Batch Feedback](https://docs.tryredrover.com/reference/add-batch-feedback): POST /review-batches/{id}/feedback. Leaves feedback on the batch as a whole, for changes that span many posts. Our team sees it on the review page. - [Get a Review Link](https://docs.tryredrover.com/reference/get-review-link): GET /review-batches/{id}/share-link. Returns the batch's review page link to share with your team. Anyone with the link can read the batch and leave notes, without signing in. - [Reset a Review Link](https://docs.tryredrover.com/reference/reset-review-link): POST /review-batches/{id}/share-link. Replaces the batch's review link with a new one. Every earlier link stops working, including any our team sent. ## Analytics - [Get Reddit Performance](https://docs.tryredrover.com/reference/get-reddit-performance): GET /analytics/reddit. Reddit results for a window: totals, a daily series and the top posts and comments. - [Get AI Search Visibility](https://docs.tryredrover.com/reference/get-ai-visibility): GET /analytics/ai-visibility. How often AI assistants mention and cite your brand: scores, per-platform results, competitors, a trend and the top prompts checked. ## Knowledge Base - [Get Company Information](https://docs.tryredrover.com/reference/get-knowledge-document): GET /knowledge-documents/{slug}. Reads a knowledge document our team and our AI work from, like your company information. - [Update Company Information](https://docs.tryredrover.com/reference/update-knowledge-document): PUT /knowledge-documents/{slug}. Replaces a knowledge document's content, saved as a new version. Earlier versions are kept. - [List Document Versions](https://docs.tryredrover.com/reference/list-knowledge-document-versions): GET /knowledge-documents/{slug}/versions. Lists a knowledge document's saved versions, newest first. - [List Banned Subreddits](https://docs.tryredrover.com/reference/list-banned-subreddits): GET /subreddit-bans. Lists the subreddits your content must never go to. - [Ban or Unban a Subreddit](https://docs.tryredrover.com/reference/set-subreddit-ban): PUT /subreddit-bans. Bans a subreddit so none of your content goes there, or lifts the ban. ## Keywords - [List Keywords](https://docs.tryredrover.com/reference/list-keywords): GET /keywords. Lists the keywords your campaign targets, with topic, cluster, search volume, difficulty and intent. - [List Target Prompts](https://docs.tryredrover.com/reference/list-target-prompts): GET /target-prompts. Lists the questions people ask AI assistants that you want to show up for, with each one's visibility over the last 30 days. - [Add Target Prompts](https://docs.tryredrover.com/reference/add-target-prompts): POST /target-prompts. Adds up to 20 prompts to track. We start checking them across AI assistants right away. - [Retire a Target Prompt](https://docs.tryredrover.com/reference/retire-target-prompt): DELETE /target-prompts/{id}. Stops tracking a prompt. Its past results are kept. ## Webhooks - [List Webhook Endpoints](https://docs.tryredrover.com/reference/list-webhooks): GET /webhooks. Lists the workspace's webhook endpoints, oldest first. - [Create a Webhook Endpoint](https://docs.tryredrover.com/reference/create-webhook): POST /webhooks. Adds an endpoint that gets the events you pick, and returns its signing secret once. - [Get a Webhook Endpoint](https://docs.tryredrover.com/reference/get-webhook): GET /webhooks/{id}. Reads one endpoint. - [Update a Webhook Endpoint](https://docs.tryredrover.com/reference/update-webhook): PATCH /webhooks/{id}. Changes an endpoint's URL, events or description, or turns it off or back on. - [Delete a Webhook Endpoint](https://docs.tryredrover.com/reference/delete-webhook): DELETE /webhooks/{id}. Deletes an endpoint and drops any deliveries still waiting to retry. - [Send a Test Event](https://docs.tryredrover.com/reference/test-webhook): POST /webhooks/{id}/test. Sends a signed `webhook.test` event to the endpoint right away and returns how it went. - [List Webhook Deliveries](https://docs.tryredrover.com/reference/list-webhook-deliveries): GET /webhooks/{id}/deliveries. The endpoint's deliveries from the last 30 days, newest first. ## Reports - [List Reports](https://docs.tryredrover.com/reference/list-reports): GET /reports. Lists the reports shared with you, newest first. - [Get a Report](https://docs.tryredrover.com/reference/get-report): GET /reports/{id}. Returns one shared report with its sections. ## Mentions - [List Mentions](https://docs.tryredrover.com/reference/list-mentions): GET /mentions. Lists Reddit posts and comments that mention you, your competitors or your topic, newest first. ## Activity - [List Activity](https://docs.tryredrover.com/reference/list-activity): GET /activity. Lists what recently happened to your content, newest first: posted, failed, cancelled, deleted or new replies. ## Strategy - [Get the Campaign Strategy](https://docs.tryredrover.com/reference/get-strategy): GET /strategy. Returns your campaign strategy brief: goals, priority subreddits, topics and the balance of direct and indirect content. - [List Blog Campaigns](https://docs.tryredrover.com/reference/list-blog-campaigns): GET /blog-campaigns. Lists your blog campaigns, newest first, with how many articles are written. ## Agency Partners - [List Clients](https://docs.tryredrover.com/reference/list-clients): GET /clients. Lists your agency's clients, oldest first, including clients added after the key was made. - [Add a Client](https://docs.tryredrover.com/reference/create-client): POST /clients. Adds a client workspace under your agency, optionally with the client's own login. - [Get a Client](https://docs.tryredrover.com/reference/get-client): GET /clients/{client}. Reads one client by workspace ID or by your reference. - [Update a Client](https://docs.tryredrover.com/reference/update-client): PATCH /clients/{client}. Renames a client or changes your reference or contact for it. - [List a Client's Posts](https://docs.tryredrover.com/reference/list-client-posts): GET /clients/{client}/posts. Lists one client's posts, like [List Posts](/docs/reference/list-posts) with X-Workspace-Id. - [Schedule a Post for a Client](https://docs.tryredrover.com/reference/create-client-post): POST /clients/{client}/posts. Schedules a post for one client, with the same rules as [Schedule a Post](/docs/reference/create-post). - [List a Client's Comments](https://docs.tryredrover.com/reference/list-client-comments): GET /clients/{client}/comments. Lists one client's comments, like [List Comments](/docs/reference/list-comments) with X-Workspace-Id. - [Schedule a Comment for a Client](https://docs.tryredrover.com/reference/create-client-comment): POST /clients/{client}/comments. Schedules a comment for one client, with the same rules as [Schedule a Comment](/docs/reference/create-comment). - [Get Agency Credits](https://docs.tryredrover.com/reference/get-agency-credits): GET /agency/credits. Your agency's credit balance and what client caps set aside. - [Get a Client's Credits](https://docs.tryredrover.com/reference/get-client-credits): GET /clients/{client}/credits. One client's cap and what it used this period. - [List Agency Webhooks](https://docs.tryredrover.com/reference/list-agency-webhooks): GET /agency/webhooks. Lists your agency's listeners, which get events for every client. - [Create an Agency Webhook](https://docs.tryredrover.com/reference/create-agency-webhook): POST /agency/webhooks. Adds a listener for all your clients' events, and returns its signing secret once. - [Get an Agency Webhook](https://docs.tryredrover.com/reference/get-agency-webhook): GET /agency/webhooks/{id}. Reads one agency listener. - [Update an Agency Webhook](https://docs.tryredrover.com/reference/update-agency-webhook): PATCH /agency/webhooks/{id}. Changes a listener's URL, events or note, or turns it off or back on. - [Delete an Agency Webhook](https://docs.tryredrover.com/reference/delete-agency-webhook): DELETE /agency/webhooks/{id}. Removes a listener and its delivery history. - [Send a Test Event to an Agency Webhook](https://docs.tryredrover.com/reference/test-agency-webhook): POST /agency/webhooks/{id}/test. Sends a `webhook.test` event right away and returns how it went. - [List Agency Webhook Deliveries](https://docs.tryredrover.com/reference/list-agency-webhook-deliveries): GET /agency/webhooks/{id}/deliveries. The listener's deliveries from the last 30 days, newest first. ## Content Tools - [Check Content](https://docs.tryredrover.com/reference/check-content): POST /content/check. Runs our writing checks on one post or comment and returns what they flag. Fast, and uses no AI credits. - [Rewrite Content](https://docs.tryredrover.com/reference/rewrite-content): POST /content/reddify. Rewrites one post or comment so it reads like a person wrote it for Reddit, then checks and revises it. - [Preview a Bulk Schedule](https://docs.tryredrover.com/reference/preview-content-batch): POST /content/batches/preview. Checks and prices up to 50 posts and comments at once, without scheduling anything. - [Confirm a Bulk Schedule](https://docs.tryredrover.com/reference/confirm-content-batch): POST /content/batches/confirm. Schedules a previewed batch, all or nothing. ## Status - [Health Check](https://docs.tryredrover.com/reference/health-check): GET /health. Returns `ok` when the API is up. Needs no API key, is not rate limited and reads no data, so it is safe to poll from uptime monitors.