RedRover Logo

Get Started

Authentication

Authenticate with an API key, or with the access token of an AI app a user connected.

Every request sends a bearer credential in the Authorization header. The API accepts two kinds, and both go through the same scope, workspace and rate limit checks.

Request Headers
GET /api/public/v1/posts HTTP/1.1
Host: app.tryredrover.com
Authorization: Bearer rr_live_...
X-Workspace-Id: 8f14e45f-ceea-4e1a-9c2b-6d7a1c3b9e21

API Keys

API keys start with rr_live_ and are for servers, scripts and integrations you run. Create them on the Developers page, where you choose the key's scopes and the workspaces it can reach. A key can only reach workspaces you are a member of.

  • The full key is shown once, when you create it. We only store a hash.
  • Keep keys on your server. Never ship one in a browser, mobile app or public repository.
  • Revoke a key on the Developers page and it stops working on the next request. The page also shows when each key was last used.
  • Use one key per integration, so you can revoke one without breaking the others.

OAuth for AI Apps

When someone adds the AI connector (https://connector.tryredrover.com/mcp) to an AI app, the app signs them in with RedRover over OAuth 2.1 and receives an access token. That token acts as the person who signed in, on the workspaces they are an active member of.

Access tokens work on every /api/public/v1 endpoint with these scopes: workspace:read, posts:read, posts:write, comments:read, comments:write, analytics:read, knowledge:write, keywords:read, keywords:write, reports:read, mentions:read, notifications:read, strategy:read. Endpoints that need another scope answer 403 for a token.

Disconnecting an App

People can revoke an app's access any time from Settings, then Connected Apps, in RedRover. The token stops working within about a minute.

Failed Authentication

A missing, malformed, invalid or revoked credential returns 401 unauthorized. A valid credential without the endpoint's scope, or without access to the workspace, returns 403 forbidden. See Errors.

401 Response
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}