---
title: " "
sidebarTitle: prefect automation
---

# `prefect automation`



```command
prefect automation [OPTIONS] COMMAND [ARGS]...
```



<Info>
Manage automations.
</Info>








## `prefect automation ls`



```command
prefect automation ls [OPTIONS]
```



<Info>
List all automations.
</Info>








## `prefect automation inspect`



```command
prefect automation inspect [OPTIONS] [NAME]
```



<Info>
Inspect an automation.

Arguments:

    name: the name of the automation to inspect

    id: the id of the automation to inspect

    yaml: output as YAML

    json: output as JSON

Examples:

    `$ prefect automation inspect "my-automation"`

    `$ prefect automation inspect --id "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"`

    `$ prefect automation inspect "my-automation" --yaml`

    `$ prefect automation inspect "my-automation" --output json`
    `$ prefect automation inspect "my-automation" --output yaml`
</Info>






<AccordionGroup>


<Accordion title="Arguments" defaultOpen>
<ResponseField name="NAME" type="string">
    An automation's name
</ResponseField>
</Accordion>



<Accordion title="Options" defaultOpen>

<ResponseField name="--id">
    An automation's id
</ResponseField>

<ResponseField name="--yaml">
    Output as YAML
</ResponseField>

<ResponseField name="--json">
    Output as JSON
</ResponseField>

<ResponseField name="--output">
    Specify an output format. Currently supports: json, yaml
</ResponseField>

</Accordion>

</AccordionGroup>



## `prefect automation resume`



```command
prefect automation resume [OPTIONS] [NAME]
```



<Info>
Resume an automation.

Arguments:

        name: the name of the automation to resume

        id: the id of the automation to resume

Examples:

        `$ prefect automation resume "my-automation"`

        `$ prefect automation resume --id "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"`
</Info>






<AccordionGroup>


<Accordion title="Arguments" defaultOpen>
<ResponseField name="NAME" type="string">
    An automation's name
</ResponseField>
</Accordion>



<Accordion title="Options" defaultOpen>

<ResponseField name="--id">
    An automation's id
</ResponseField>

</Accordion>

</AccordionGroup>



## `prefect automation enable`



```command
prefect automation enable [OPTIONS] [NAME]
```



<Info>
Resume an automation.

Arguments:

        name: the name of the automation to resume

        id: the id of the automation to resume

Examples:

        `$ prefect automation resume "my-automation"`

        `$ prefect automation resume --id "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"`
</Info>






<AccordionGroup>


<Accordion title="Arguments" defaultOpen>
<ResponseField name="NAME" type="string">
    An automation's name
</ResponseField>
</Accordion>



<Accordion title="Options" defaultOpen>

<ResponseField name="--id">
    An automation's id
</ResponseField>

</Accordion>

</AccordionGroup>



## `prefect automation pause`



```command
prefect automation pause [OPTIONS] [NAME]
```



<Info>
Pause an automation.

Arguments:

        name: the name of the automation to pause

        id: the id of the automation to pause

Examples:

    `$ prefect automation pause "my-automation"`

    `$ prefect automation pause --id "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"`
</Info>






<AccordionGroup>


<Accordion title="Arguments" defaultOpen>
<ResponseField name="NAME" type="string">
    An automation's name
</ResponseField>
</Accordion>



<Accordion title="Options" defaultOpen>

<ResponseField name="--id">
    An automation's id
</ResponseField>

</Accordion>

</AccordionGroup>



## `prefect automation disable`



```command
prefect automation disable [OPTIONS] [NAME]
```



<Info>
Pause an automation.

Arguments:

        name: the name of the automation to pause

        id: the id of the automation to pause

Examples:

    `$ prefect automation pause "my-automation"`

    `$ prefect automation pause --id "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"`
</Info>






<AccordionGroup>


<Accordion title="Arguments" defaultOpen>
<ResponseField name="NAME" type="string">
    An automation's name
</ResponseField>
</Accordion>



<Accordion title="Options" defaultOpen>

<ResponseField name="--id">
    An automation's id
</ResponseField>

</Accordion>

</AccordionGroup>



## `prefect automation delete`



```command
prefect automation delete [OPTIONS] [NAME]
```



<Info>
Delete an automation.
</Info>






<AccordionGroup>


<Accordion title="Arguments" defaultOpen>
<ResponseField name="NAME" type="string">
    An automation's name
</ResponseField>
</Accordion>



<Accordion title="Options" defaultOpen>

<ResponseField name="--id">
    An automation's id
</ResponseField>

<ResponseField name="--all">
    Delete all automations
</ResponseField>

</Accordion>

</AccordionGroup>


<Note>
**Example:**

`$ prefect automation delete "my-automation"`
`$ prefect automation delete --id "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"`
`$ prefect automation delete --all`
</Note>




## `prefect automation create`



```command
prefect automation create [OPTIONS]
```



<Info>
Create one or more automations from a file or JSON string.
</Info>






<AccordionGroup>




<Accordion title="Options" defaultOpen>

<ResponseField name="--from-file">
    Path to YAML or JSON file containing automation(s)
</ResponseField>

<ResponseField name="--from-json">
    JSON string containing automation(s)
</ResponseField>

</Accordion>

</AccordionGroup>


<Note>
**Example:**

`$ 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", ...}]'`
</Note>

