Send a cron job heartbeat ping
Authorization
ApiKeyAuth X-SeeStack-Key<token>
Raw API key for SDK ingestion endpoints. The backend validates this key and resolves the associated project automatically.
Send the raw key as-is.
Example: seestack_live_abc123xyz...
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "http://localhost:8080/ingest/v1/heartbeat" \ -H "Content-Type: application/json" \ -d '{ "slug": "daily-report-generator", "status": "success", "durationMs": 4320, "message": "Processed 1842 records, report emailed to 12 recipients" }'{
"ok": true,
"monitorId": "3f2a1b4c-5d6e-7f8a-9b0c-1d2e3f4a5b6c"
}{
"success": false,
"error": {
"code": "INVALID_API_KEY",
"message": "Invalid or missing API key"
},
"meta": {
"requestId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"timestamp": "2026-03-31T12:00:00.000Z"
}
}{
"ok": false,
"code": "NOT_FOUND",
"message": "No cron monitor found with slug: daily-report-generator"
}{
"ok": false,
"code": "VALIDATION_ERROR",
"message": "Status must be 'success' or 'failed'"
}{
"ok": false,
"message": "Failed to publish event"
}