cron-jobs

Update cron job delivery channel

Passing null clears the explicit channel marker; a job that had an explicit channel reverts to headless, while a job that never had one keeps its origin delivery.

put/v1/cron-jobs/{cron_job_id}/delivery-channel

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/{cron_job_id}/delivery-channel
  • Auth: HTTP bearer

Path parameters

cron_job_idstring uuid required

Headers

X-Tenant-Idstring nullable

Request body

delivery_channel_idstring nullable required

Response

The updated 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

Changes

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