Create a prompt

Creates a new prompt under a monitor in the active project.

POST /api/v1/prompts

The new prompt joins its monitor on the next scheduled run, provided it was created with is_active set to true. Inactive prompts are skipped by every run until you reactivate them through Update a prompt.

Body parameters

Name	Type	Required	Description
monitor_id	integer	Required	The numeric ID of the monitor that will own the new prompt. The monitor must belong to the active project.
prompt	string	Required	The question the monitor will ask each engine on every run. May be up to 2000 characters.
is_active	boolean	Required	When set to `true`, the prompt will run on every daily run. When set to `false`, the prompt is skipped.

Response

The prompt object

Field	Type	Description
id	integer	The unique ID of the prompt.
monitor_id	integer	The ID of the monitor that owns this prompt.
prompt	string	The question text the monitor asks each engine on every run.
is_active	boolean	Whether the prompt will run on each daily run of its monitor.
created_at	datetime	When the prompt was created.
updated_at	datetime	When the prompt was last updated.

curl -X POST https://pineprompt.com/api/v1/prompts \ -H "Authorization: Bearer $PINEPROMPT_TOKEN" \ -H "Pineprompt-Project-Id: 1" \ -H "Content-Type: application/json" \ -d '{ "monitor_id": 271, "prompt": "What are the best AI visibility monitoring tools?", "is_active": true }'

import os import requests response = requests.post( "https://pineprompt.com/api/v1/prompts", headers={ "Authorization": f"Bearer {os.environ['PINEPROMPT_TOKEN']}", "Pineprompt-Project-Id": "1", "Content-Type": "application/json", }, json={ "monitor_id": 271, "prompt": "What are the best AI visibility monitoring tools?", "is_active": True, }, ) response.raise_for_status() payload = response.json()

use GuzzleHttp\Client; $response = (new Client())->post('https://pineprompt.com/api/v1/prompts', [ 'headers' => [ 'Authorization' => 'Bearer '.getenv('PINEPROMPT_TOKEN'), 'Pineprompt-Project-Id' => '1', ], 'json' => [ 'monitor_id' => 271, 'prompt' => 'What are the best AI visibility monitoring tools?', 'is_active' => true, ], ]); // Guzzle throws on 4xx/5xx by default, so no manual check needed. $payload = json_decode((string) $response->getBody(), true);

{ "id": 901, "monitor_id": 271, "prompt": "What are the best AI visibility monitoring tools?", "is_active": true, "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }