Health checks
The settings, the run in progress, and the latest finished run by provider and by offering.
Enter your API key here (sent as Otari-Key header).
Successful Response
The Health page: settings, the run in progress, and the latest finished run by provider.
GET /api/v1/health-checks HTTP/1.1
Otari-Key: YOUR_API_KEY
Accept: */*
Successful Response
{
"last_run": {
"failed": 1,
"finished_at": "2026-01-01T00:00:00.000Z",
"id": "text",
"included_reasoning": true,
"passed": 1,
"started_at": "2026-01-01T00:00:00.000Z",
"total": 1
},
"providers": [
{
"answered": 1,
"history": [
{
"answered": 1,
"started_at": "2026-01-01T00:00:00.000Z",
"total": 1
}
],
"provider": "text",
"status": "ok",
"top_error": "text",
"top_error_count": 1,
"total": 1
}
],
"results": [
{
"checked_at": "2026-01-01T00:00:00.000Z",
"error": "text",
"failed_runs": 0,
"failing_since": "2026-01-01T00:00:00.000Z",
"latency_ms": 1,
"provider": "text",
"selector": "text",
"status": "pass",
"status_code": 1
}
],
"running": {
"failed": 1,
"finished_at": "2026-01-01T00:00:00.000Z",
"id": "text",
"included_reasoning": true,
"passed": 1,
"started_at": "2026-01-01T00:00:00.000Z",
"total": 1
},
"settings": {
"alert_emails": [
"text"
],
"interval_minutes": 1,
"max_tokens": 1,
"next_run_at": "2026-01-01T00:00:00.000Z",
"prompt": "text",
"reasoning_every_runs": 1,
"reasoning_max_tokens": 1,
"run_requested": true,
"schedule_enabled": true
}
}Stop serving every model the latest run found failing, on its hosted provider.
Each stays listed on the Hosted providers page, priced, to be switched back on there.
Enter your API key here (sent as Otari-Key header).
Successful Response
What switching off the failing models did.
How many models were switched off on their hosted provider.
POST /api/v1/health-checks/disable-failing HTTP/1.1
Otari-Key: YOUR_API_KEY
Accept: */*
Successful Response
{
"disabled": 1
}Start a run within a minute, whether or not the schedule is on.
Enter your API key here (sent as Otari-Key header).
Successful Response
Whether the checks run, how often, and what they send.
POST /api/v1/health-checks/run HTTP/1.1
Otari-Key: YOUR_API_KEY
Accept: */*
Successful Response
{
"alert_emails": [
"text"
],
"interval_minutes": 1,
"max_tokens": 1,
"next_run_at": "2026-01-01T00:00:00.000Z",
"prompt": "text",
"reasoning_every_runs": 1,
"reasoning_max_tokens": 1,
"run_requested": true,
"schedule_enabled": true
}Whether the checks run on a schedule, how often, and what they send.
Enter your API key here (sent as Otari-Key header).
Successful Response
Whether the checks run, how often, and what they send.
GET /api/v1/health-checks/settings HTTP/1.1
Otari-Key: YOUR_API_KEY
Accept: */*
Successful Response
{
"alert_emails": [
"text"
],
"interval_minutes": 1,
"max_tokens": 1,
"next_run_at": "2026-01-01T00:00:00.000Z",
"prompt": "text",
"reasoning_every_runs": 1,
"reasoning_max_tokens": 1,
"run_requested": true,
"schedule_enabled": true
}Change the settings. Turning the schedule on starts a run within a minute.
Enter your API key here (sent as Otari-Key header).
Settings to change. An omitted field keeps its value.
Who is emailed when a model stops answering and when it answers again. An empty list emails nobody.
Minutes between scheduled runs.
Output cap for a model that does not reason.
The user message every model is sent. A check passes on any answer, whatever it says.
Include reasoning models every Nth run; 0 leaves them out.
Output cap for a reasoning model.
Run the checks on a schedule.
Successful Response
Whether the checks run, how often, and what they send.
Validation Error
PATCH /api/v1/health-checks/settings HTTP/1.1
Otari-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 47
{
"interval_minutes": 60,
"schedule_enabled": true
}{
"alert_emails": [
"text"
],
"interval_minutes": 1,
"max_tokens": 1,
"next_run_at": "2026-01-01T00:00:00.000Z",
"prompt": "text",
"reasoning_every_runs": 1,
"reasoning_max_tokens": 1,
"run_requested": true,
"schedule_enabled": true
}Last updated
Was this helpful?
