Trigger FTP Check

POST /api/ftp-monitors/:ftpMonitorPublicId/trigger-check

Authentication

Authorization: Bearer <token>

Parameters

• ftpMonitorPublicId (Path, required): FTP monitor public UUID.

Example (cURL)

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

curl -X POST \
  "$BASE_URL/api/ftp-monitors/55555555-5555-4555-8555-555555555555/trigger-check" \
  -H "Authorization: Bearer $TOKEN"

Response

{
  "success": true,
  "message": "Checks triggered successfully",
  "ftpMonitorId": 400,
  "locationCodes": ["DE", "US"],
  "queueNames": ["ftp-monitor-checks-DE", "ftp-monitor-checks-US"]
}

Common Errors

• 400 FTP monitor public ID (UUID) required if ftpMonitorPublicId is missing or invalid
• 400 No eligible monitoring locations for the selected allowed countries if your country restrictions match no active locations
• 401 Unauthorized if you are not authenticated
• 403 Forbidden if you do not have write access
• 503 No active monitoring locations available if no worker locations are active