Tasks

Create and manage recurring CloudX analyses with the cloudx CLI.

Tasks

The cloudx tasks commands manage recurring CloudX analyses for your account.

A Task runs a prompt on a five-field cron schedule. CloudX evaluates the schedule in the selected IANA timezone.

Available commands:

cloudx tasks list lists Tasks in newest-first order.
cloudx tasks get shows one Task.
cloudx tasks create creates a Task.
cloudx tasks update changes a Task.
cloudx tasks enable and cloudx tasks disable control scheduled runs.
cloudx tasks run queues an enabled Task now.
cloudx tasks delete deletes a Task.

Task commands require the Tasks feature. Read commands require configuration:read. Write commands require editor access and configuration:write.

Create a task

--prompt and --schedule are required. CloudX creates an enabled, private Task in UTC unless you set different values.

cloudx tasks create \
  --name "Weekly revenue review" \
  --prompt "Review weekly revenue and flag material changes" \
  --schedule "0 9 * * 1" \
  --timezone Europe/Madrid \
  --access workspace

Omit --name to let CloudX derive a name from the prompt.

Create flags

Flag	Required	Default	Description
`--prompt`	Yes		Prompt to run.
`--schedule`	Yes		Five-field cron expression.
`--name`	No	Derived	Task name. Maximum 120 characters.
`--timezone`	No	`UTC`	IANA timezone for the schedule.
`--enabled`	No	`true`	Create the Task enabled.
`--access`	No	`private`	Who can access the Task and receive notifications: `private` or `workspace`.
`--json`	No	`false`	Print structured JSON.

Private Tasks are visible only to their creator. Workspace Tasks are visible to everyone in the workspace.

List and inspect Tasks

cloudx tasks list
cloudx tasks list --json
cloudx tasks get task_123
cloudx tasks get task_123 --json

The list view shows each Task ID, name, schedule, timezone, access, status, and next run time. The detail view also shows the prompt, creator, and creation source.

Update a Task

Set one or more fields to update. Omitted fields keep their current values.

cloudx tasks update task_123 --schedule "0 10 * * 1"
cloudx tasks update task_123 --timezone America/New_York
cloudx tasks update task_123 --access workspace

update accepts --name, --prompt, --schedule, --timezone, --access, and --json. Only the Task creator can change a workspace Task to private.

Enable, disable, and run a Task

Disable a Task to pause its scheduled runs. Enabling it resumes the schedule.

cloudx tasks disable task_123
cloudx tasks enable task_123
cloudx tasks run task_123

cloudx tasks run queues one immediate run. The Task must be enabled and must not have an active run.

Delete a Task

cloudx tasks delete task_123

CloudX rejects deletion while the Task has an active run.

Structured output

All Task commands accept --json. Use it for scripts and agent workflows.

cloudx tasks create \
  --prompt "Summarize yesterday's performance" \
  --schedule "0 8 * * *" \
  --json

Task responses include the cron expression, timezone, human-readable schedule, state, access mode, creator when applicable, next run time, timestamps, and creation source.