Skip to main content
POST
Create a new task automation

Body

application/json
name
string
required

Task automation name

agent
string

Auto-dispatch follow-up tasks to this agent

checkpoint
string

Override follow-up checkpoint interval

detached
boolean

Do not link the follow-up task as a child of the trigger task

disabled
boolean

Create the automation disabled

filter
string

Optional filter expression on task event data

freshCheckpoint
boolean

Do not inherit the trigger task checkpoint

freshReportEvents
boolean

Do not inherit the trigger task report events

freshReportTo
boolean

Do not inherit the trigger task report target

freshWorktree
boolean

Do not inherit the trigger task worktree

input
string[]

Profile input templates for the follow-up task

instructions
string

Follow-up task instructions template

on
string

Comma-separated events: task.blocked,task.done,task.failed,task.child.blocked,task.child.done,task.child.failed

priority
string

low|normal|high|urgent (default: inherit trigger task)

profile
string

Follow-up task profile (default: inherit trigger task profile)

reportEvents
string

Comma-separated report events: blocked,done,failed

reportTo
string

Override follow-up report target session

session
string

Optional session name template for auto-dispatch

title
string

Follow-up task title template

Response

Success — no @Returns schema declared; payload shape is loose.

The response is of type object.