Trigger SSL Check

curl -X POST "https://kodostatus.com/api/v1/ssl-monitors/ssl_abc123" \
  -H "X-API-Key: your_api_key"

const response = await fetch('https://kodostatus.com/api/v1/ssl-monitors/ssl_abc123', {
  method: 'POST',
  headers: { 'X-API-Key': 'your_api_key' }
});
const result = await response.json();
console.log(`Certificate expires in ${result.days_until_expiry} days`);

{
  "status": "ok",
  "days_until_expiry": 76,
  "valid_to": "2026-05-01T00:00:00Z",
  "issuer": "Let's Encrypt Authority X3",
  "subject": "api.example.com",
  "error": null,
  "response_time_ms": 245
}

POST

ssl-monitors

{id}

curl -X POST "https://kodostatus.com/api/v1/ssl-monitors/ssl_abc123" \
  -H "X-API-Key: your_api_key"

const response = await fetch('https://kodostatus.com/api/v1/ssl-monitors/ssl_abc123', {
  method: 'POST',
  headers: { 'X-API-Key': 'your_api_key' }
});
const result = await response.json();
console.log(`Certificate expires in ${result.days_until_expiry} days`);

{
  "status": "ok",
  "days_until_expiry": 76,
  "valid_to": "2026-05-01T00:00:00Z",
  "issuer": "Let's Encrypt Authority X3",
  "subject": "api.example.com",
  "error": null,
  "response_time_ms": 245
}

Manually trigger an SSL certificate check outside the regular monitoring interval. The check verifies certificate validity, expiration, and chain of trust.

Path Parameters

string

required

The SSL monitor ID

Response

string

Check result: ok, warning, critical, or error

number

Days until the certificate expires

string

Certificate expiration date (ISO 8601)

string

Certificate Authority name

string

Certificate subject (domain)

string

Error message if the check failed (null on success)

number

Time taken to complete the check in milliseconds

curl -X POST "https://kodostatus.com/api/v1/ssl-monitors/ssl_abc123" \
  -H "X-API-Key: your_api_key"

const response = await fetch('https://kodostatus.com/api/v1/ssl-monitors/ssl_abc123', {
  method: 'POST',
  headers: { 'X-API-Key': 'your_api_key' }
});
const result = await response.json();
console.log(`Certificate expires in ${result.days_until_expiry} days`);

{
  "status": "ok",
  "days_until_expiry": 76,
  "valid_to": "2026-05-01T00:00:00Z",
  "issuer": "Let's Encrypt Authority X3",
  "subject": "api.example.com",
  "error": null,
  "response_time_ms": 245
}

Delete SSL Monitor List Domain Monitors

Overview

Status Pages

Status Page Design

Incidents

Services

Uptime Monitors

SSL Monitors

Domain Monitors

Heartbeat

Metrics

Notification Channels

Webhooks

Error Tracking

Releases

Source Maps

Maintenance

Configuration

Workflows

API Keys

Audit Log

Beacon

Trigger SSL Check

Path Parameters

Response

​Path Parameters

​Response

Path Parameters

Response