> ## Documentation Index
> Fetch the complete documentation index at: https://developers.clay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# workflows get

> Fetch a single workflow by id.

Fetch one workflow by id. The response returns the workflow `id`, `name`, and a `url` that opens it in Clay. To list every workflow in the workspace, use [`clay workflows list`](/cli/reference/workflows-list).

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay workflows get <workflowId>
```

## Arguments

| Argument     | Description                              |
| ------------ | ---------------------------------------- |
| `workflowId` | Workflow id, e.g. `wf_abc123`. Required. |

## Output

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "wf_abc123",
  "name": "Lead enrichment",
  "url": "https://app.clay.com/..."
}
```

| Field  | Type   | Description                           |
| ------ | ------ | ------------------------------------- |
| `id`   | string | Workflow id.                          |
| `name` | string | Display name.                         |
| `url`  | string | Link that opens the workflow in Clay. |

## Errors

| Code               | Exit | Notes                                         |
| ------------------ | ---- | --------------------------------------------- |
| `validation_error` | 2    | `workflowId` argument is required.            |
| `not_found`        | 6    | No workflow with that id.                     |
| `auth_forbidden`   | 3    | The API key lacks the `terracotta:cli` scope. |

## Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay workflows get wf_abc123
clay workflows get wf_abc123 | jq -r '.url'
clay workflows list | jq -r '.data[0].id' | xargs clay workflows get
```
