cron-jobs

Create cron job

Create a new scheduled job, attributed to the requesting actor.

post/v1/cron-jobs

Request

  • Base URL: https://api.patricia.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.patricia.app/v1/cron-jobs
  • Auth: HTTP bearer

Headers

X-Tenant-Idstring nullable

Request body

namestring required
schedulestring nullable
local_schedulestring nullable
timezonestring nullable
run_atstring date-time nullable
kind_code'reminder' | 'task'

What a fired CronJob does (plan 02 §6).

reminder pings the originating conversation with the stored message (no agent run); task runs the stored prompt as a scheduled agent action and delivers the result back to that conversation.

promptstring required
condition_scriptstring nullable
enabledboolean
modelstring
cost_tierstring nullable
max_runsinteger nullable
delivery_channel_idstring nullable

Response

The created cron job.

idstring uuid required
tenant_idstring uuid required
namestring required
schedulestring nullable
local_schedulestring nullable
timezonestring nullable
run_atstring date-time nullable
kind_code'reminder' | 'task' required

What a fired CronJob does (plan 02 §6).

reminder pings the originating conversation with the stored message (no agent run); task runs the stored prompt as a scheduled agent action and delivers the result back to that conversation.

delivery_conversation_idstring uuid nullable
delivery_channel_idstring nullable
delivery_destination_kind'dm' | 'channel' | 'unknown_channel' nullable
billing_skip_reason'no_credits' | 'subscription_inactive' nullable
delivery_channel_namestring nullable
created_by_actor_idstring uuid nullable
built_in_template_keystring nullable
viewer_may_change_instructionsboolean nullable
auto_approve_level'read_only' | 'read_and_write' nullable
summarystring nullable
instructionsstring nullable
instructions_author_actor_idstring uuid nullable
promptstring required
condition_scriptstring nullable
enabledboolean required
modelstring required
cost_tierstring nullable
locked_bystring nullable
lease_expires_atstring date-time nullable
last_run_atstring date-time nullable
next_run_atstring date-time nullable
run_countinteger required
max_runsinteger nullable
created_atstring date-time required
updated_atstring date-time required
connection_scope_notestring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.