v3

latestOpenAPI 3.0.02026-08-051879161.2 MB
Check sessions
Triggers

Trigger a new check session

Starts a check session for each check that matches the provided target filters. If no filters are given, matches all eligible checks.

This endpoint does not wait for the check session to complete. Use the GET /v2/check-sessions/{checkSessionId}/completion or GET /v2/check-sessions/{checkSessionId} endpoints to track progress.

Use POST /v1/check-sessions/{checkSessionId}/cancel to cancel an in-progress check session.

Standard alerting rules apply to finished check runs.

Equivalent to the Schedule Now button in the UI.

post/v2/check-sessions/trigger

Headers

x-checkly-accountstring uuid

Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

Request body

refreshCacheboolean

Refresh the selected checks cache before triggering the sessions.

Response

Created