One-off tasks

Schedule a single call to your app from its server-side code with createCronClient. mybase calls the same endpoint as for scheduled jobs, signed with the cron secret. Scheduling needs a mybase API key with cron:write for the project (mybase token create shop-app --project shop --perm cron:write), not an admin one.

Schedule a taskCopy Anchor Link

import { createCronClient } from "@mybase-dev/sdk/cron";

const cron = createCronClient({
  apiUrl: process.env.MYBASE_URL!,        // mybase, reachable from your app
  project: "shop",
  apiKey: process.env.MYBASE_API_KEY!,     // cron:write for this project
  baseUrl: "https://shop.example.com",    // your app, reachable from mybase
});

const task = await cron.schedule("send-reminder", {
  in: "24h",
  payload: { orderId: 42 },
  key: "reminder-42",
});

await cron.get(task.id);                 // task, or null if not found
await cron.getByKey("reminder-42");
await cron.cancelByKey("reminder-42"); // only pending tasks can be cancelled

Handle the callCopy Anchor Link

Add a "send-reminder" job to your cronHandler's jobs map. Its run.trigger is "task", run.runId is the task ID, and run.key is the optional dedupe key.

Scheduling and deliveryCopy Anchor Link

• in accepts milliseconds or "30s", "15m", "2h", "7d"; at accepts a date or date string. Omit both to run as soon as possible. You cannot pass both.
• key deduplicates while a task is pending or running. After it finishes, the key is free again.
• path defaults to /api/cron and appends to baseUrl; url overrides both. Set retries (0–5) and timeoutMs (1000–120000) per task if needed.
• Tasks persist in Postgres. Due tasks run when mybase restarts; interrupted tasks can run again. Dedupe on run.runId for non-repeatable side effects.
• get, getByKey, cancel, and cancelByKey return null for unknown tasks. Cancelling an already-run task throws MybaseApiError with status: 409.

Finished and cancelled tasks remain for seven days. Each project can have up to 10,000 pending tasks. Keep the API key server-side.