RedRover Logo

Keywords

Add Target Prompts

Adds up to 20 prompts to track. We start checking them across AI assistants right away.

POST/target-prompts
Scope: keywords:writeAI Connector Tool: redrover_add_target_prompts

Prompts the workspace already tracks are skipped and counted in duplicates. First results show up in List Target Prompts once the checks finish.

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

Body

  • promptsstring[]Required

    1 to 20 prompts, each 3 to 500 characters

    1 to 20 items

Response

201 What was saved.

  • dataobjectRequired
    Show 3 Child Fields
    • addedintegerRequired

      Prompts saved

    • duplicatesintegerRequired

      Prompts left out because the workspace already tracks them

    • promptIdsstring[]Required

      IDs of the prompts saved

Errors

Every error uses the error envelope.

  • 400prompts is empty, too long, or holds more than allowed
  • 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/target-prompts" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "X-Workspace-Id: $REDROVER_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "prompts": [
    "What is the best product analytics tool for a small SaaS?",
    "How do I measure feature adoption?"
  ]
}'
201 Response
{
  "data": {
    "added": 1,
    "duplicates": 1,
    "promptIds": [
      "5d2c8e41-9a7b-4f3e-8c6d-1b0a2e4f6c8d"
    ]
  }
}