Trigger Website Check

POST /api/websites/:websitePublicId/trigger-check

AuthenticationCopy Anchor Link

Requires a valid session with write access to the website.

• Header: Authorization: Bearer <token>

ParametersCopy Anchor Link

• websitePublicId (Path, required): Website public UUID.

Example (cURL)Copy Anchor Link

BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X POST \
  "$BASE_URL/api/websites/6bfec6f6-245a-47ce-843b-157d97d56f88/trigger-check" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Example ResponseCopy Anchor Link

{
  "success": true,
  "message": "Check triggered successfully",
  "websiteId": 123
}

The check is enqueued for the website's active monitoring locations; results land in the check history a few seconds later.

Common ErrorsCopy Anchor Link

• 400 Website public ID (UUID) required if :websitePublicId is invalid
• 401 Unauthorized if you are not authenticated
• 403 Forbidden if you do not have write access to the website
• 429 Check recently triggered (data.retryAfterMs) when the same website was triggered within the last 10 seconds; the same cooldown every monitor family has
• 503 No active monitoring locations available