monitors

Create a monitor

Creates a new monitor in the active project. Every monitor binds a set of prompts to one or more AI platforms, in a chosen country and language.

post/api/v1/monitors

Request

  • Base URL: https://pineprompt.com
  • URL: https://pineprompt.com/api/v1/monitors
  • Auth: HTTP bearer

Headers

Pineprompt-Project-Idinteger required

The active project's numeric ID.

Request body

namestring required

A human-readable name for the monitor. May be up to <strong>120</strong> characters.

platformsstring[] required

The AI platforms you would like the monitor to run against. Each platform must support the chosen country; sending an unsupported pair will return a 422 response.

countrystring required

A two-letter <a href='https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2' class='underline'>ISO 3166-1 alpha-2</a> country code, such as US, NL, or GB. Pineprompt stores the value uppercased, so you may send us as well.

languagestring required

A two-letter language code, such as en or nl. The field allows up to 10 characters so that regional variants may be expressed when needed.

is_activeboolean required

When set to true, the monitor will run on its next daily run. When set to false, the monitor is paused and consumes no quota.

Example request

{
  "name": "Brand visibility (US)",
  "platforms": [
    "chatgpt",
    "perplexity",
    "claude"
  ],
  "country": "US",
  "language": "en",
  "is_active": true
}

Response

Created

idinteger

The unique ID of the monitor.

project_idinteger

The ID of the project this monitor runs under.

namestring

The display name of the monitor.

platformsstring[]

The AI platforms the monitor runs against.

countrystring

The ISO 3166-1 alpha-2 country code.

languagestring

The language the monitor runs in.

is_activeboolean

Whether the monitor will run on its next daily run.

created_atstring date-time

When the monitor was created.

updated_atstring date-time

When the monitor was last updated.

Example response

{
  "id": 271,
  "project_id": 42,
  "name": "Brand visibility (US)",
  "platforms": [
    "chatgpt",
    "perplexity",
    "claude"
  ],
  "country": "US",
  "language": "en",
  "is_active": true,
  "project": {
    "id": 42,
    "organization_id": 7,
    "name": "Acme Marketing",
    "brand_id": 555,
    "organization": {
      "id": 7,
      "name": "Acme Inc.",
      "created_at": "2026-05-15T09:11:42+00:00",
      "updated_at": "2026-05-15T09:11:42+00:00"
    },
    "created_at": "2026-05-15T09:11:42+00:00",
    "updated_at": "2026-05-15T09:11:42+00:00"
  },
  "created_at": "2026-05-15T09:11:42+00:00",
  "updated_at": "2026-05-15T09:11:42+00:00"
}

Changes

No recorded changes to this operation across all 1 revision of this API.