Skip to main content
POST
The endpoint returns HTTP 202 with a run whose status is queued. Use its id with Get a run to follow progress and retrieve changes. If this monitor already has a queued or running run, the endpoint returns HTTP 409 with run_in_progress and current_run_id. A paused monitor returns HTTP 409 with invalid_state; resume it before requesting a run.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

monitor_id
string
required

Monitor identifier (mon_...)

Response

The queued run

id
string
required

Opaque ID with the prefix run_

Maximum string length: 64
object
enum<string>
required
Available options:
monitor.run
monitor_id
string
required
trigger
enum<string>
required

What started the run. New triggers may be added; accept unknown values.

Available options:
schedule,
manual
status
enum<string>
required

queued is a manual run that has not started. skipped is a run that did not start, including a queued run cancelled by pausing the monitor. New statuses may be added; treat an unknown one as not finished.

Available options:
queued,
running,
succeeded,
failed,
skipped
counts
object
required
usage
object
required

Usage for the run. Only a succeeded run has nonzero usage. Search monitors report successful search calls in searches but are billed once per run; Page monitors report counted fetched_urls. The other counter is zero. Judging is included in the price.

changes
object[]
required

One finding the judge kept. New types may be added; skip changes with an unknown type.

target_errors
object[]
required
created_at
string<date-time>
required

RFC 3339 in UTC with whole seconds, for example 2026-11-12T09:00:41Z.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$
window
object

Omitted while the run is queued

error
object

Only on failed and skipped runs

finished_at
string<date-time>

Omitted until the run ends

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$