Cron jobs

This feature is currently in private beta, to enable, please contact us.

Cron jobs on Sailhouse allow you to, on a regular schedule, fire events into topics to trigger regular behaviour. If you want to send a daily email roundup at 9am, or calculate usage every hour, cron jobs are the perfect way to do this.

Creating a cron job

To define a cron, you can head to Apps -> your_app -> Crons, and click on Create cron.

Here, you can define a name, the target topic, and the frequency of which it’s triggered. For example, here is a daily cron which runs at 1:30am UTC.

All cron jobs are triggered in UTC time

Handling a cron event

With cron events firing into regular Sailhouse topics, you can subscribe to them as normal. The event that’s published contains useful metadata about the cron that triggered it.

{
  "cron_id": "2hfy70ox3i5y",
  "cron_name": "Every 30 minutes",
  "cron_schedule": "0 */30 * * *"
}

You can read more about subscribing to topics here.

Editing a cron job

From the cron job page, you can edit the name and schedule of the cron, as well pausing/resuming on demand.

Q&A

When will cron jobs be released?

Cron jobs aim to launch within Q1 2025.

What’s the minimum amount of time between a cron run?

There is a hard system limitation of 1 minute between subsequent runs. Any definitions with shorter durations than this will run at 1 minute intervals.

What if the events are unacknowledged?

As the topic the cron fires into is a regular topic, these will build up as per usual on subscriptions.

Can I manually fire the cron?

As it’s a normal topic, you can fire an event in as per usual! Just make sure to match the data/metadata if you depend on it.

Get Started

Guides

Concepts

SDKs

Observability

Reference

Creating a cron job

Handling a cron event

Editing a cron job

Q&A

When will cron jobs be released?

What’s the minimum amount of time between a cron run?

What if the events are unacknowledged?

Can I manually fire the cron?

​Creating a cron job

​Handling a cron event

​Editing a cron job

​Q&A

​When will cron jobs be released?

​What’s the minimum amount of time between a cron run?

​What if the events are unacknowledged?

​Can I manually fire the cron?

Creating a cron job

Handling a cron event

Editing a cron job

Q&A

When will cron jobs be released?

What’s the minimum amount of time between a cron run?

What if the events are unacknowledged?

Can I manually fire the cron?