API Reference

Base URL : https://cronbeacon.com/api/v1

Authentication : Authorization: Bearer cb_your_token

POST /api/v1/ingest/events

Send a monitoring event (start, success, failure).

Request body

Field	Type	Required	Description
job_key	string	✅	Unique job identifier (slug). Automatically created if it doesn't exist.
event	string	✅	Event type: started, succeeded, failed, completed
environment	string		Environment (prod, staging, dev). Default: prod
duration_ms	integer		Execution duration in milliseconds
processed_count	integer		Number of items processed
error_count	integer		Number of errors encountered
message	string		Free text message (error detail, summary...)
event_id	string		Unique ID for event deduplication (idempotency)

Event types

• started — Job has started
• succeeded — Job succeeded
• failed — Job failed
• completed — Job completed (without success/failure indication)

Response

{
  "status": "ok",
  "run_id": "01924f8a-...",
  "job_id": "01924f8a-...",
  "event": "succeeded",
  "created": true
}

GET /api/v1/jobs

List all jobs in the tenant.

POST /api/v1/jobs

Create a new job.

Request body

Field	Type	Description
name	string	Job name (slug is generated automatically)
type	string	cron, batch, worker
environment	string	prod, staging, dev
cron_expression	string	Standard cron expression (5 fields)
expected_cadence_minutes	integer	Alternative to cron: interval in minutes
grace_period_seconds	integer	Grace period in seconds before declaring missed (default: 300)
severity	string	low, medium, high, critical

GET /api/health

Check that the service is operational. No authentication required.

POST /api/v1/alerts/{id}/ack

Acknowledge an alert (sets status to 'acked').

POST /api/v1/alerts/{id}/mute

Mute an alert. Parameter: minutes (mute duration).