Skip to main content
POST
/
v1
/
topics
/
{topicId}
/
prompts
Create prompts
curl --request POST \
  --url https://api.example.com/v1/topics/{topicId}/prompts \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompts": [
    {}
  ]
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.get-spotlight.com/llms.txt

Use this file to discover all available pages before exploring further.

Adds one or more prompts to an existing topic. Enforces the same prompt quota as Batch create.

​
Path parameters

​
topicId
string
required
Topic UUID. Obtain from Create topics or the Spotlight app.

​
Request body

​
prompts
PromptInput[]
required

​
Request

curl -s -X POST \
  -H "x-spotlight-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompts": [
      { "text": "How competitive is the pricing?", "customerJourney": "consideration" }
    ]
  }' \
  "https://app.get-spotlight.com/api/v1/topics/TOPIC_ID/prompts"

​
Response

{
  "prompts": [
    { "id": "prompt-uuid-1", "text": "How competitive is the pricing?", "customerJourney": "consideration" }
  ],
  "remainingSlots": 86
}