Skip to main content
POST
/
prompts
Create Prompt
curl --request POST \
  --url https://server.promptwatch.com/api/v2/prompts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "prompt": "<string>",
  "llmMonitorId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "languageCode": "en-US",
  "keywords": [
    "<string>"
  ],
  "tags": [
    "<string>"
  ],
  "isActive": true
}
'
{
  "id": "6ba7b830-9dad-11d1-80b4-00c04fd430c8",
  "prompt": "Track brand mentions in ChatGPT answers?",
  "type": "ORGANIC",
  "intent": null,
  "isActive": true,
  "llmMonitorId": "6ba7b815-9dad-11d1-80b4-00c04fd430c8",
  "languageCode": "en-US",
  "createdAt": "2026-03-30T10:00:00.000Z"
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Get yours from the Promptwatch dashboard under Settings > API Keys.

Body

application/json
​
prompt
string
required

The prompt text

Minimum string length: 1
​
llmMonitorId
string<uuid>
required

Monitor to attach prompt to

​
type
enum<string>
required

Type of prompt

Available options:
ORGANIC,
BRAND_SPECIFIC,
COMPETITOR_COMPARISON
​
intent
enum<string> | null

Intent of the prompt

Available options:
BRANDED,
INFORMATIONAL,
NAVIGATIONAL,
COMMERCIAL,
TRANSACTIONAL
​
languageCode
string
default:en-US

Language code

​
keywords
string[]

Optional keywords

​
tags
string[]

Optional tag names

​
isActive
boolean
default:true

Whether prompt is active

Response

Default Response

​
id
string<uuid>
required
​
prompt
string
required
​
type
string
required
​
isActive
boolean
required
​
llmMonitorId
string<uuid>
required
​
createdAt
string<date-time>
required
​
intent
string | null
​
languageCode
string