API
Create a key in Settings → API and send it in the X-Api-Key header.
GET https://taskbeacon.io/api/v1/jobs list your jobs
POST https://taskbeacon.io/api/v1/jobs create one: {"name": "Sales", "period_minutes": 1440}
GET https://taskbeacon.io/api/v1/jobs/ID one job
DELETE https://taskbeacon.io/api/v1/jobs/ID delete (owner only)
A job's ping_url is only included for people who may edit it.
alerts_on is false for a job that is watched but sends no alerts; send "alerts_on": false
when you create a job to start it that way (default true).
Ping addresses
Pings need no key: the address itself is the secret. GET and POST both work (a POST body up to 10 KB is kept; for a failure its last 10 KB).
https://taskbeacon.io/ping/ID finished (numbers after ?, e.g. ?rows=15234, or a JSON body) https://taskbeacon.io/ping/ID/start started https://taskbeacon.io/ping/ID/fail failed (?exit_code=, ?rc=, ?error=, the output as the body) https://taskbeacon.io/ping/ID/0 finished, by exit code https://taskbeacon.io/ping/ID/N failed with exit code N (any other number)
A HEAD request (link previews) is answered but never counts as a run. See Exit code and Words in the output.