> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prefect.io/llms.txt
> Use this file to discover all available pages before exploring further.
# automation
# `prefect.cli.automation`
Automation command — native cyclopts implementation.
Manage automations.
## Functions
### `ls`
```python theme={null}
ls()
```
List all automations.
### `inspect`
```python theme={null}
inspect(name: Annotated[Optional[str], cyclopts.Parameter(show=False, help="An automation's name.")] = None)
```
Inspect an automation.
**Examples:**
```bash theme={null}
$ prefect automation inspect "my-automation"
$ prefect automation inspect --id "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
$ prefect automation inspect "my-automation" --output json
$ prefect automation inspect "my-automation" --output yaml
```
### `resume`
```python theme={null}
resume(name: Annotated[Optional[str], cyclopts.Parameter(show=False, help="An automation's name.")] = None)
```
Resume an automation.
**Examples:**
```bash theme={null}
$ prefect automation resume "my-automation"
$ prefect automation resume --id "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
```
### `pause`
```python theme={null}
pause(name: Annotated[Optional[str], cyclopts.Parameter(show=False, help="An automation's name.")] = None)
```
Pause an automation.
**Examples:**
```bash theme={null}
$ prefect automation pause "my-automation"
$ prefect automation pause --id "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
```
### `delete`
```python theme={null}
delete(name: Annotated[Optional[str], cyclopts.Parameter(show=False, help="An automation's name.")] = None)
```
Delete an automation.
**Examples:**
```bash theme={null}
$ prefect automation delete "my-automation"
$ prefect automation delete --id "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
$ prefect automation delete --all
```
### `create`
```python theme={null}
create()
```
Create one or more automations from a file or JSON string.
**Examples:**
```bash theme={null}
$ prefect automation create --from-file automation.yaml
$ prefect automation create -f automation.json
$ prefect automation create --from-json '{"name": "my-automation", "trigger": {...}, "actions": [...]}'
$ prefect automation create -j '[{"name": "auto1", ...}, {"name": "auto2", ...}]'
```
### `update`
```python theme={null}
update()
```
Update an existing automation from a file or JSON string.
**Examples:**
```bash theme={null}
$ prefect automation update --id "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa" --from-file automation.yaml
$ prefect automation update --id "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa" -f automation.json
$ prefect automation update --id "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa" --from-json '{"name": "updated-automation", "trigger": {...}, "actions": [...]}'
```