Trigger ICMP Check

POST /api/icmp-monitors/:icmpMonitorPublicId/trigger-check

Authentication

Requires a valid session.

• Header: Authorization: Bearer <token>

Parameters

• icmpMonitorPublicId (Path, required): ICMP monitor public UUID.

cURL

curl -X POST "https://YOUR_DOMAIN/api/icmp-monitors/22222222-2222-4222-8222-222222222222/trigger-check" \
  -H "Authorization: Bearer $TOKEN"

Response

{
  "success": true,
  "message": "Checks triggered successfully",
  "icmpMonitorId": 123,
  "locationCodes": ["fra", "nyc"],
  "queueNames": ["icmp-monitor-checks-fra", "icmp-monitor-checks-nyc"]
}

Errors

• 400 ICMP monitor public ID (UUID) required or no eligible locations
• 401 Unauthorized
• 403 Forbidden
• 404 ICMP monitor not found
• 503 No active monitoring locations available
• 500 Failed to trigger check