Cron jobs — scheduled work with full CRUD, pause/resume, run-now, and execution history.
Mutating calls (create, update, pause, resume, run_now) send an
Idempotency-Key header automatically.
Example
client = Miosa.client(System.fetch_env!("MIOSA_API_KEY"))
{:ok, job} = Miosa.CronJobs.create(client, %{
name: "nightly-report",
schedule: "0 4 * * *",
url: "https://api.example.com/reports"
})
{:ok, _} = Miosa.CronJobs.run_now(client, job["id"])
{:ok, history} = Miosa.CronJobs.list_executions(client, job["id"])Summary
Functions
Create a cron job.
Delete a cron job by ID.
Fetch a cron job by ID.
Get a specific execution record for a cron job.
List cron jobs for the authenticated tenant.
List execution history for a cron job.
Pause a cron job (stops future scheduled runs).
Resume a paused cron job.
Trigger an immediate execution of a cron job outside its schedule.
Update a cron job.
Functions
@spec create(Miosa.Client.t(), map()) :: Miosa.Client.result(map())
Create a cron job.
Required: :name, :schedule (cron expression e.g. "0 4 * * *").
Optional: :url, :payload, :timezone, :enabled, :idempotency_key.
@spec delete(Miosa.Client.t(), String.t()) :: Miosa.Client.result(map())
Delete a cron job by ID.
@spec get(Miosa.Client.t(), String.t()) :: Miosa.Client.result(map())
Fetch a cron job by ID.
@spec get_execution(Miosa.Client.t(), String.t(), String.t()) :: Miosa.Client.result(map())
Get a specific execution record for a cron job.
@spec list(Miosa.Client.t(), keyword() | map()) :: Miosa.Client.result(map())
List cron jobs for the authenticated tenant.
Accepts optional filters as a keyword list or map (e.g. :limit, :cursor).
@spec list_executions(Miosa.Client.t(), String.t(), keyword() | map()) :: Miosa.Client.result(map())
List execution history for a cron job.
@spec pause(Miosa.Client.t(), String.t()) :: Miosa.Client.result(map())
Pause a cron job (stops future scheduled runs).
@spec resume(Miosa.Client.t(), String.t()) :: Miosa.Client.result(map())
Resume a paused cron job.
@spec run_now(Miosa.Client.t(), String.t()) :: Miosa.Client.result(map())
Trigger an immediate execution of a cron job outside its schedule.
@spec update(Miosa.Client.t(), String.t(), map()) :: Miosa.Client.result(map())
Update a cron job.
Pass any fields to update; nil values are dropped.