---
title: esc env schedule new | CLI commands
url: /docs/esc/cli/commands/esc_env_schedule_new/
---

Create a new scheduled action on an environment.

## Synopsis

[EXPERIMENTAL] Create a new scheduled action on an environment

This command schedules a secret rotation against the environment. Use --cron to
schedule a recurring rotation or --once to schedule a single rotation at a
specific time (ISO 8601 / RFC 3339).

Only one schedule per environment is currently supported; creating a second
schedule will fail. The minimum cron interval is once per day.

```
esc env schedule new [<org-name>/][/]<environment-name> [flags]
```

## Options

```
      --cron string   a cron expression for a recurring schedule (minimum interval: once daily)
  -h, --help          help for new
      --once string   an ISO 8601 / RFC 3339 timestamp in the future for a one-time schedule
```

## Options inherited from parent commands

```
      --env string   The name of the environment to operate on.
```

## SEE ALSO

* [esc env schedule](/docs/esc/cli/commands/esc_env_schedule/)	 - Manage environment scheduled actions