---
title: "Trigger FTP Check"
description: "Triggers an immediate check from all eligible monitoring locations."
---

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

## Authentication

`Authorization: Bearer <token>`

## Parameters

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

## Example (cURL)

```bash
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

```json
{
  "success": true,
  "message": "Checks triggered successfully",
  "ftpMonitorId": 400,
  "locationCodes": ["de-nbg", "fi-hel"],
  "queueNames": ["ftp-monitor-checks-de-nbg", "ftp-monitor-checks-fi-hel"]
}
```

## 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