---
title: "Trigger Website Check"
description: "Triggers an immediate check of a website across eligible monitoring locations."
---

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

## Authentication

Requires a valid session with write access to the website.

- Header: `Authorization: Bearer <token>`

## Parameters

- `websitePublicId` (Path, required): Website public UUID.

## Example (cURL)

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

```json
{
  "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 Errors

- `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
- `503 No active monitoring locations available`