Run a check once, now
POST/api/v1/orgs/:org/checks/:checkUid/run-now
"Run now": runs any check once, on demand, in every region, instead of waiting for its next period. Each region's job is made due at once and the workers are told; a region whose job is mid-run keeps the request and runs again as soon as that run ends (its current run started before the request, so it is not the answer). Every region is reported queued. The results go through the normal path, so they can open or resolve an incident like any scheduled result. A result with periodStart >= requestedAt is this request's answer. This is an action path: it does not create the multi-step run resource at …/run. Rate limited per check and per organization (3 per minute and 60 per hour; browser, js, rdp and vnc checks 1 per minute and 20 per hour); a refusal carries Retry-After. Requires write access (viewers get 403).
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 429
The run is requested
Authentication required
Permission denied
Resource not found
The check has no scheduled run (it is disabled)
Rate limited (code RATE_LIMITED). Retry-After gives the seconds until the refusing window reopens.