Skip to content

Plan schedules

The ayx one plans schedules command returns the schedules configured for a plan. It is a read-only command — schedule creation and modification are handled through the Alteryx One platform.

Command What it does
ayx one plans schedules List schedules for a plan
Terminal window
ayx one plans schedules <plan-id>
ayx one plans schedules <plan-id> --profile <name>

Returns all schedules attached to the plan. Each schedule entry includes the recurrence definition, enabled state, and next run time.

Terminal window
ayx --output json one plans schedules <plan-id>

The response follows the standard envelope:

{
"ok": true,
"message": "...",
"timestamp_utc": "...",
"data": [...]
}

data contains the array of schedule records.

Check whether a plan has any active schedules

Section titled “Check whether a plan has any active schedules”
Terminal window
ayx --output json one plans schedules <plan-id> \
| jq '[.data[] | select(.enabled == true)] | length'
Terminal window
ayx --output json one plans list --all | jq -r '.data[].id' \
| while IFS= read -r id; do
ayx --output json one plans schedules "$id" \
| jq -r --arg id "$id" '.data[] | [$id, .nextRun] | @tsv'
done