RedRover Logo

Workspaces

Get Workspace Profile

Reads the workspace's company profile: website, description, keywords, subreddits, competitors and brand names.

GET/workspace/profile
Scope: workspace:readAI Connector Tool: redrover_get_workspace_profile

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

Response

200 The profile.

  • dataobjectRequired
    Show 8 Child Fields
    • idstringRequired

      Workspace ID

    • namestringRequired

      Company or workspace name

    • websitestringRequired

      Company website

      nullable

    • descriptionstringRequired

      What the company does

      nullable

    • keywordsstring[]Required

      Target keywords

    • subredditsstring[]Required

      Subreddits to focus on, as bare names

    • competitorsobject[]Required

      Tracked competitors

      Show 2 Child Fields
      • namestringRequired
      • websitestringRequired
    • brandNamesstring[]Required

      Brand names our checks accept in content

Errors

Every error uses the error envelope.

  • 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 "https://app.tryredrover.com/api/public/v1/workspace/profile" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "X-Workspace-Id: $REDROVER_WORKSPACE_ID"
200 Response
{
  "data": {
    "id": "8f14e45f-ceea-4e1a-9c2b-6d7a1c3b9e21",
    "name": "Acme Analytics",
    "website": "https://acme.example",
    "description": "Product analytics for small SaaS teams.",
    "keywords": [
      "product analytics",
      "saas metrics"
    ],
    "subreddits": [
      "startups",
      "SaaS"
    ],
    "competitors": [
      {
        "name": "Example Metrics",
        "website": "https://metrics.example"
      }
    ],
    "brandNames": [
      "Acme",
      "Acme Analytics"
    ]
  }
}