CHchecklyhq
Check sessions
Triggers

Trigger a new check session

Changed on

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

Request

Headers

x-checkly-accountstring uuid

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

Changes

  • bc90d1bfa738Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • a4fea1ad9b9aRevision changes
    • warning

      added the new GRPC enum value to the // response property for the response status

    • warning

      added the new SSL enum value to the // response property for the response status

    • warning

      added the new TRACEROUTE enum value to the // response property for the response status