Add prompts

Adds one or more prompts to track in one country, and returns their IDs in request order. If any prompt fails, the prompts already added by the call are removed.

  • country_code defaults to the project's primary market. It must be the primary market or one of the project's additional countries; this endpoint can't add a new country.
  • The plan's prompt limit applies per country.
  • Prompt texts must be unique within the country, ignoring case and whitespace, including against each other in the same request. The check runs before anything is added, so retrying after a timeout is safe.

Each new prompt adds to the cost of every scheduled and manual run (prompts × AI models).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The site's unique name (its ID), returned when the site is created.

Body Params
string

Country for the new prompts, as an ISO 3166-1 alpha-2 code. Case-insensitive. Must be the primary market or one of the project's additional countries. Defaults to the primary market.

prompts
array of objects
required
length ≥ 1

The prompts to add.

prompts*
string
required

The question to ask the AI answer engines.

Responses

Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json