Guides

Schedules

Cron expressions invoke a project HTTP route in-process.

Dashboard Schedules (/projects/:id/schedules) stores a 5-field cron, method, path, optional JSON body, and enabled flag. Maximum 20 schedules. Minimum interval is one minute. Starbase ticks every 60s and invokes the matching route with header x-robodev-schedule. Use defineApi({ auth: "schedule" }) so only signed ticks can call the handler.

import { defineApi } from "@robodev-ai/sdk";
export const post = defineApi({
  auth: "schedule",
  handler: async ({ schedule }) => ({ ok: true, schedule }),
});