Update Monitor

Python

from parallel import Parallel

client = Parallel()

monitor = client.monitor.update(
    "monitor_id",
    frequency="12h",
    type="event_stream",
    settings={"query": "Extract recent funding news about AI startups"},
)
print(monitor.frequency)

import Parallel from "parallel-web";

const client = new Parallel();

const monitor = await client.monitor.update('monitor_id', {
    frequency: '12h',
    type: 'event_stream',
    settings: { query: 'Extract recent funding news about AI startups' },
});
console.log(monitor.frequency);

HttpResponse<String> response = Unirest.post("https://api.parallel.ai/v1/monitors/{monitor_id}/update")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

{
  "monitor_id": "<string>",
  "frequency": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "settings": {
    "query": "<string>",
    "output_schema": {
      "json_schema": {},
      "type": "json"
    },
    "include_backfill": true,
    "advanced_settings": {
      "source_policy": {
        "exclude_domains": [
          "reddit.com",
          "x.com",
          ".ai"
        ],
        "include_domains": [
          "wikipedia.org",
          "usa.gov",
          ".edu"
        ]
      },
      "location": "us"
    }
  },
  "webhook": {
    "url": "<string>",
    "event_types": []
  },
  "metadata": {
    "slack_thread_id": "1234567890.123456",
    "user_id": "U123ABC"
  },
  "last_run_at": "2025-01-15T10:30:00Z",
  "output": {
    "latest_snapshot": {
      "basis": [
        {
          "field": "<string>",
          "reasoning": "<string>",
          "citations": [],
          "confidence": "low"
        }
      ],
      "type": "<string>",
      "content": "<string>",
      "mcp_tool_calls": [
        {
          "tool_call_id": "<string>",
          "server_name": "<string>",
          "tool_name": "<string>",
          "arguments": "<string>",
          "content": "<string>",
          "error": "<string>"
        }
      ],
      "beta_fields": {}
    }
  }
}

{
  "type": "error",
  "error": {
    "ref_id": "fcb2b4f3-c75e-4186-87bc-caa1a8381331",
    "message": "Unauthorized: invalid or missing credentials"
  }
}

{
  "type": "error",
  "error": {
    "ref_id": "fcb2b4f3-c75e-4186-87bc-caa1a8381331",
    "message": "Monitor not found"
  }
}

{
  "type": "error",
  "error": {
    "ref_id": "fcb2b4f3-c75e-4186-87bc-caa1a8381331",
    "message": "Unprocessable content: request validation error"
  }
}

POST

monitors

{monitor_id}

update

Python

from parallel import Parallel

client = Parallel()

monitor = client.monitor.update(
    "monitor_id",
    frequency="12h",
    type="event_stream",
    settings={"query": "Extract recent funding news about AI startups"},
)
print(monitor.frequency)

import Parallel from "parallel-web";

const client = new Parallel();

const monitor = await client.monitor.update('monitor_id', {
    frequency: '12h',
    type: 'event_stream',
    settings: { query: 'Extract recent funding news about AI startups' },
});
console.log(monitor.frequency);

HttpResponse<String> response = Unirest.post("https://api.parallel.ai/v1/monitors/{monitor_id}/update")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

{
  "monitor_id": "<string>",
  "frequency": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "settings": {
    "query": "<string>",
    "output_schema": {
      "json_schema": {},
      "type": "json"
    },
    "include_backfill": true,
    "advanced_settings": {
      "source_policy": {
        "exclude_domains": [
          "reddit.com",
          "x.com",
          ".ai"
        ],
        "include_domains": [
          "wikipedia.org",
          "usa.gov",
          ".edu"
        ]
      },
      "location": "us"
    }
  },
  "webhook": {
    "url": "<string>",
    "event_types": []
  },
  "metadata": {
    "slack_thread_id": "1234567890.123456",
    "user_id": "U123ABC"
  },
  "last_run_at": "2025-01-15T10:30:00Z",
  "output": {
    "latest_snapshot": {
      "basis": [
        {
          "field": "<string>",
          "reasoning": "<string>",
          "citations": [],
          "confidence": "low"
        }
      ],
      "type": "<string>",
      "content": "<string>",
      "mcp_tool_calls": [
        {
          "tool_call_id": "<string>",
          "server_name": "<string>",
          "tool_name": "<string>",
          "arguments": "<string>",
          "content": "<string>",
          "error": "<string>"
        }
      ],
      "beta_fields": {}
    }
  }
}

{
  "type": "error",
  "error": {
    "ref_id": "fcb2b4f3-c75e-4186-87bc-caa1a8381331",
    "message": "Unauthorized: invalid or missing credentials"
  }
}

{
  "type": "error",
  "error": {
    "ref_id": "fcb2b4f3-c75e-4186-87bc-caa1a8381331",
    "message": "Monitor not found"
  }
}

{
  "type": "error",
  "error": {
    "ref_id": "fcb2b4f3-c75e-4186-87bc-caa1a8381331",
    "message": "Unprocessable content: request validation error"
  }
}

Authorizations

x-api-key

string

header

required

Path Parameters

monitor_id

string

required

Body

application/json

Request body to update a monitor.

Only fields that are explicitly included in the request body are updated. Pass null for webhook or metadata to clear those fields. To update type-specific settings on an event_stream monitor, include type and settings; pass settings.query to update the prompt, or null for settings.advanced_settings to clear it. If settings is provided, type is required to identify the settings shape. The request must still include at least one field to update; empty updates fail validation.

type

enum<string> | null

Type of the monitor being updated. Required when settings is provided; must be event_stream (snapshot monitors have no updatable type-specific settings).

Available options:

event_stream,

snapshot

Example:

"event_stream"

frequency

string | null

Frequency of the monitor. Format: '' where unit is 'h' (hours), 'd' (days), or 'w' (weeks). Must be between 1h and 30d (inclusive).

Example:

"1h"

webhook

MonitorWebhook · object | null

Webhook to receive notifications about the monitor's execution.

Show child attributes

metadata

Metadata · object | null

User-provided metadata stored with the monitor and echoed back in webhook notifications and GET responses, so you can map events to objects in your application. Keys: max 16 chars; values: max 512 chars.

Show child attributes

Example:

{
  "slack_thread_id": "1234567890.123456",
  "user_id": "U123ABC"
}

settings

UpdateMonitorEventStreamSettings · object | null

Type-specific settings to update. Only valid when type is event_stream. Pass settings.query to update the prompt, or null for settings.advanced_settings to clear it.

Show child attributes

Response

Monitor updated successfully.

Response object for a monitor.

The type field at the root determines the concrete shape of settings: event_stream uses MonitorEventStreamResponseSettings, and snapshot uses MonitorSnapshotResponseSettings. Snapshot monitors also carry an output field (MonitorSnapshotOutput) with the latest computed state.

type

enum<string>

required

The type of monitor.

Available options:

event_stream,

snapshot

Examples:

"event_stream"

"snapshot"

monitor_id

string

required

ID of the monitor.

status

enum<string>

required

Status of the monitor.

Available options:

active,

cancelled

Examples:

"active"

"cancelled"

frequency

string

required

Frequency of the monitor. Format: '' where unit is 'h' (hours), 'd' (days), or 'w' (weeks). Must be between 1h and 30d (inclusive).

Examples:

"1h"

"12h"

"1d"

"7d"

"30d"

processor

enum<string>

required

Processor to use for the monitor. lite is faster and cheaper; base performs more thorough analysis at higher cost and latency. Defaults to lite.

Available options:

lite,

base

Examples:

"lite"

"base"

created_at

string<date-time>

required

Timestamp of the creation of the monitor, as an RFC 3339 string.

Example:

"2025-01-15T10:30:00Z"

settings

MonitorEventStreamResponseSettings · object

required

Type-specific response fields for an event_stream monitor.

MonitorEventStreamResponseSettings
MonitorSnapshotResponseSettings

Show child attributes

webhook

MonitorWebhook · object | null

Webhook configuration for the monitor.

Show child attributes

metadata

Metadata · object | null

Show child attributes

Example:

{
  "slack_thread_id": "1234567890.123456",
  "user_id": "U123ABC"
}

last_run_at

string | null

Timestamp of the last run for the monitor, as an RFC 3339 string.

Example:

"2025-01-15T10:30:00Z"

output

MonitorSnapshotOutput · object | null

Runtime output state. Present only for snapshot monitors; null for event_stream monitors.

Show child attributes

⌘I

Search

Extract

Tasks

FindAll

Monitor

Chat API (Beta)

Responses API

Authorizations

Path Parameters

Body

Response