Skip to main content
POST
Add pages to monitor
Adds up to 50 URLs on the workspace domain to the monitored pages. A URL that is already monitored is reported as already_monitored. Adding a page does not audit it: start an audit with Start a page audit. Requires an active Business, Agency Business or Enterprise plan, and an API token with write access enabled by an Owner or Manager. See Writing data for activation, idempotency, conditional requests and error handling.
string
required
Bearer token for your team.
string
required
Unique key for this operation, at most 255 characters. Completed responses replay for 24 hours.
string
required
Workspace identifier. The workspace must belong to the token’s team.
string[]
required
Between 1 and 50 absolute URLs of at most 2048 characters.

Response

Returns 200 with an items array, one entry for each submitted URL. pageId is null when the URL was not added.

Synthetic request and response

Errors

See Error codes for authentication, plan, idempotency and server errors. A token without write access returns 403 API_KEY_READ_ONLY. On 429, honor Retry-After. If the write limiter is unavailable or writes are suspended, the request returns 503 SERVICE_UNAVAILABLE and nothing changes.