Schedule a skill
Run a skill on a schedule.
cron: a 5-field cron expression, for example0 9 * * 1-5.every:hourly,daily,daily 09:00,weekly mon 09:00,30 minutes,2h, or the app’s formsdaily:09:00,weekly:mon:09:00,interval:30.
timezone (an IANA name, default UTC), inputs for every run (checked now), max_results (rows per run, default 100, 0 for all), and enabled (default true).
A skill has one schedule. If it already has one you get 409 with its id: change it with Update a schedule. Each scheduled run spends the owner’s credits.
Owner or workspace editor. Needs skills:write. MCP tool: schedule_skill.Authorizations
API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.
Headers
Any unique string (such as your order id). Resending the same request with the same key within 24 hours returns the first answer (with Idempotent-Replayed: true) and does nothing twice; the same key with a different request is a 422 idempotency_key_reused.
1 - 255Path Parameters
Body
5-field cron, e.g. '0 9 * * 1-5'
'hourly', 'daily', 'daily 09:00', 'weekly mon 09:00', '30 minutes' / '2h', or daily:09:00 / weekly:mon:09:00 / interval:30
IANA name, e.g. 'Europe/London'
Inputs each scheduled run uses
Rows per run; 0 = all; default 100
0 <= x <= 500Response
The new schedule.
The same shape as a workflow's schedule (GET /v1/schedules lists both), plus max_results.
The schedule id: PATCH / DELETE /v1/schedules/{id}
The cadence in words
The cadence as the app stores it
"skill"The cadence as 5-field cron (null for '30 minutes')

