User Job Create

Author a personal scheduled cron job by writing a .md file under /user_jobs/. Validates the cron expression and refuses to overwrite an existing job. The scheduler hot-reloads (~30s) and starts firing the job. See features/user-jobs for the schema.

MCP name: user_job_create

Category: status

Mutates state (retry policy: manual)

Parameters

Name	Type	Required	Description
capability	str	No	(type=capability) Registered capability name to invoke.
enabled	bool	No	Whether the job is enabled at create time. Default true.
jitter_seconds	int	No	Optional stable jitter applied on top of cron eligibility. Non-negative integer; jobs fire at scheduled_at + a deterministic offset in [0, jitter_seconds]. Default 0 (no jitter — fire inline on cron match). Tick cadence quantizes values < ~30s away in practice; recommended floor is 60. See features/user-jobs.
job_type	str	No	One of: capability, workflow, prompt.
name	str	Yes	Job name (becomes the filename stem); 1-64 chars, alphanumeric + - + _.
overwrite	bool	No	If true, replace an existing job file with the same name. Default false (refuses to overwrite). Used by the Edit-job flow in the dashboard.
params	dict	No	(type=capability) Parameters dict for the capability.
prompt	str	No	(type=prompt) Body text used as the agent prompt.
recurring	bool	No	False = one-shot (schedule cleared after first fire). Default true.
schedule	str	Yes	5-field cron expression (MIN HOUR DOM MON DOW).
workflow	str	No	(type=workflow) Registered workflow name to start.