descriptionstring nullable required
kind'agent' | 'script' required
promptstring nullable required
success_criteriastring nullable required
trigger_type'immediate' | 'cron' | 'interval' | 'once' | 'event' required
cron_expressionstring nullable required
interval_secondsinteger nullable required
scheduled_atstring date-time nullable required
event_conditionsobject nullable required
condition_scriptstring nullable required
pre_run_scriptstring nullable required
scriptstring nullable required
delivery_methodsstring[] required
approval_mode'autonomous' | 'supervised' | 'read_only' required
model_idstring nullable required
agent'business' | 'engineering' required
visibility'account' | 'personal' required
expires_atstring date-time nullable required
next_run_atstring date-time nullable required
last_run_atstring date-time nullable required
total_runs_countinteger required
consecutive_failure_countinteger required
total_credits_consumedinteger required
created_atstring date-time required
updated_atstring date-time required
max_runs_per_dayinteger nullable required
Event tasks: the most event-started runs per day (account time zone); later events are skipped as rate_limited.
min_interval_secondsinteger nullable required
Event tasks: the cooldown after an event-started run; events inside it are skipped as rate_limited.
site_idstring nullable required
source'user' | 'agent' | 'system' required
How the task came to exist: user (a person made it in the dashboard), agent (the agent made it inside the chat origin_chat_id, whose person is created_by_id), or system (a built-in task).
created_by_idstring nullable required
The person (user_...) who made the task or asked for it. Null for built-in tasks.
created_by_namestring nullable required
origin_chat_idstring nullable required
The chat (aichat_...) the task was set up in. A member's chat opens only for that member.