> For the complete documentation index, see [llms.txt](https://paperspace.gitbook.io/gradient/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://paperspace.gitbook.io/gradient/master/workflows/overview/getting-started-with-workflows.md).

# Getting Started with Workflows

## Creating Gradient Workflows

{% hint style="info" %}
View the full CLI/SDK Docs for **Workflows** here <https://paperspace.github.io/gradient-cli/gradient.cli.html#gradient-workflows>
{% endhint %}

1. Make sure you have the latest version of the [Gradient CLI](/gradient/master/get-started/install-the-cli.md)
2. Create a  [Gradient Project](/gradient/master/projects/managing-projects.md) and [grab your project ID](/gradient/master/projects/managing-projects.md#get-your-projects-id)
3. Create your first workflow using the Gradient CLI

```bash
gradient workflows create --name <MY_FIRST_WORKFLOW> --projectId <project-id>
```

## Running your first workflow run

Create a workflow spec yaml file ([View the full workflow yaml spec](/gradient/master/workflows/overview/workflow-spec.md)). You will also need:

**`workflow-id`** : Grab this by running `gradient workflows list` in the CLI i.e. `7634c165-5034-4f49-95fa-005fc0e7970b`

**`cluster-id`** : Currently workflows require that you have a [Gradient Private Cluster.](/gradient/master/gradient-private-cloud/setup/managed-installation.md) The cluster ID looks like this: `cla7rjbzz`

```bash
gradient workflows run  \
    --id <worklow-id> \ 
    --clusterId <cluster-id> \
    --path ./workflow.yaml 
```

##