---
title: "Run a monitor now, once"
method: POST
path: "/monitors/{monitorId}/run"
tags: ["Monitors"]
---

# Run a monitor now, once

`POST /monitors/{monitorId}/run`

## Request

- Base URL: `https://api.domscout.io`
- URL: `https://api.domscout.io/monitors/{monitorId}/run`
- Auth: API key in header `x-api-key`

Enqueues exactly one extra check immediately, without waiting for the interval and without advancing the schedule — the next scheduled run still happens when it was going to.

Bounded three ways: one run per call, with no count parameter; refused with 409 MONITOR_RUN_IN_FLIGHT while a run for this monitor is already pending or running, so it cannot be used to fan out; and billed exactly like a scheduled run, drawing on the same quota and refused by the same 429 wall.

A paused monitor is refused with 409 MONITOR_PAUSED. Poll GET /monitors/{monitorId}/runs for the outcome.

## Path parameters

- `monitorId` string, uuid, required

## Response `202`

Queued.

- object
  - `status` string
  - `monitorId` string
  - `monitorRunId` string
  - `pollUrl` string
  - `creditCost` integer

## Other responses

- `403`: A platform hold on browser execution.
- `404`: Not found.
- `409`: Paused, or a run is already in flight.
- `429`: Rate or quota wall.
- `503`: A dependency this request needs is unavailable or not configured for this deployment. Codes: SUPABASE_TIMEOUT and SUPABASE_INVALID_RESPONSE (a storage operation did not answer, or answered unreadably — the write may have committed, so any retry must be idempotent), CAPTURE_ARTIFACT_UNAVAILABLE and CAPTURE_ARTIFACT_CORRUPT (a stored artifact could not be read or parsed), ASYNC_JOBS_NOT_CONFIGURED and CAPTURE_RETRIEVAL_NOT_CONFIGURED (the capability is not configured here, on any plan). Retryable unless the code names a deployment configuration.

---

[API](https://skmtc.dev/domscout/apis/domscout-api.md) · [All operations](https://skmtc.dev/domscout/apis/domscout-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domscout/apis/domscout-api/revisions/20562d5b5d94?raw)