API Documentation

Headers

Content-Type: application/json

Body (JSON)

Monitor types

Monitor status (color)

The optional monitor_status field controls the color tint of the monitor card on the dashboard. It is independent of the log status field.

When omitted, the monitor card renders with a neutral appearance.

Example: sending a monitor

curl -X POST https://app.logblazer.com/api/logs/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "payload": "Health check passed",
    "status": "SUCCESS",
    "source": "health-checker",
    "monitor_title": "API Status",
    "monitor_type": "status",
    "monitor_value": "healthy",
    "monitor_status": "success"
  }'

201 Created

{
  "message": "Log received"
}

404 Not Found

Returned when the API key does not match any project.

422 Unprocessable Entity

Returned when validation fails (e.g. missing payload or invalid status value).

cURL

curl -X POST https://app.logblazer.com/api/logs/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{"payload": "User signed up", "status": "SUCCESS", "source": "auth-service"}'

JavaScript (fetch)

await fetch("https://app.logblazer.com/api/logs/YOUR_API_KEY", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    payload: "Deployment finished",
    status: "SUCCESS",
    source: "deploy-script"
  })
});

PHP

$response = Http::post("https://app.logblazer.com/api/logs/YOUR_API_KEY", [
    'payload' => 'Database backup completed',
    'status'  => 'SUCCESS',
    'source'  => 'backup-worker',
]);

Python

import requests

requests.post("https://app.logblazer.com/api/logs/YOUR_API_KEY", json={
    "payload": "Cron job failed: timeout after 30s",
    "status": "FAILURE",
    "source": "cron-worker"
})

Bash (minimal)

# Minimum required — just the payload
curl -X POST https://app.logblazer.com/api/logs/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{"payload": "Something happened"}'

Response

Returns text/plain Markdown with monitors table and recent log entries. No authentication required.

# My Project — Dashboard

Generated: 2026-03-05 14:30:00 UTC

## Monitors (2)

| Monitor | Value | Monitor Status | Updated |
|---|---|---|---|
| API Status | healthy | success | 2026-03-05 14:25:00 |
| Deploy | DEPLOYED | success | 2026-03-05 14:20:00 |

## Recent Logs (3)

| Time | Source | Status | Payload |
|---|---|---|---|
| 2026-03-05 14:25:00 | health-checker | SUCCESS | Health check passed |
| 2026-03-05 14:20:00 | deploy-pipeline | SUCCESS | Production deployed |
| 2026-03-05 14:15:00 | cron | NOTICE | Backup completed |

Usage

curl https://app.logblazer.com/d/YOUR_API_KEY/llm

Use this endpoint to give AI agents and LLMs access to your project's current status. The same public dashboard is also available as a web page at /d/{api_key}.

Register a heartbeat

{
  "id": "uuid",
  "name": "My App Production",
  "short_name": null,
  "url": "https://myapp.com/api/heartbeat",
  "interval_minutes": 3,
  "timeout_seconds": 10,
  "alert_emails": ["ops@myapp.com"],
  "alert_after_failures": 2,
  "is_active": true,
  "last_status": "UNKNOWN",
  "created_at": "2026-03-09T12:00:00Z"
}

Other heartbeat endpoints

Expected response

{
  "status": "PASS",
  "checks": {
    "database": {
      "status": "PASS",
      "ms": 3,
      "detail": "SELECT 1 succeeded",
      "label": "DB Connection"
    },
    "queue_health": {
      "status": "PASS",
      "detail": "No stale jobs"
    },
    "external_api": {
      "status": "FAIL",
      "ms": 5023,
      "detail": "Timeout after 5s"
    }
  }
}

HTTP status codes

Return 200 when all checks pass and 503 when one or more checks fail. Any other status code, timeout, or connection error is treated as a complete failure.

Example: registering and checking a heartbeat

# Register a heartbeat
curl -X POST https://app.logblazer.com/api/heartbeats/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production API",
    "url": "https://myapp.com/api/heartbeat",
    "interval_minutes": 5,
    "alert_emails": ["ops@myapp.com"],
    "alert_after_failures": 3
  }'

# Check status
curl https://app.logblazer.com/api/heartbeats/YOUR_API_KEY/HEARTBEAT_ID/status

# Trigger an immediate check
curl -X POST https://app.logblazer.com/api/heartbeats/YOUR_API_KEY/HEARTBEAT_ID/check

How it works