---
title: "aeontel workflow"
description: "Manage workflows"
section: "CLI"
group: "Commands"
order: 839
---

## Workflow commands

### `aeontel workflow run`

Run a workflow

```ts
aeontel workflow run <workflowId> [--input <json>]
```

```bash
aeontel workflow run wor_...
```

### `aeontel workflow add-edge`

Add an edge to a workflow

```ts
aeontel workflow add-edge <workflowId> [--source <nodeId>] [--target <nodeId>]
```

```bash
aeontel workflow add-edge wor_...
```

### `aeontel workflow add-listener`

Add an event listener to a workflow

```ts
aeontel workflow add-listener <workflowId> --event <type> --workspace <id>
```

```bash
aeontel workflow add-listener wor_... --event agent.created --workspace wsp_...
```

### `aeontel workflow add-node`

Add a node to a workflow

```ts
aeontel workflow add-node <workflowId> --type <type> --name <name> [--config <json>]
```

```bash
aeontel workflow add-node wor_... --type agent.created --name "My name"
```

### `aeontel workflow cancel-run`

Cancel a workflow

```ts
aeontel workflow cancel-run <workflowId> <runId>
```

```bash
aeontel workflow cancel-run wor_... run_...
```

### `aeontel workflow delete-edge`

Delete a workflow edge

```ts
aeontel workflow delete-edge <edgeId>
```

```bash
aeontel workflow delete-edge edg_...
```

### `aeontel workflow delete-listener`

Soft-delete a listener (restorable until retention expires)

```ts
aeontel workflow delete-listener <triggerId>
```

```bash
aeontel workflow delete-listener tri_...
```

### `aeontel workflow delete-node`

Delete a workflow node

```ts
aeontel workflow delete-node <nodeId>
```

```bash
aeontel workflow delete-node nod_...
```

### `aeontel workflow edges`

List workflow edges

```ts
aeontel workflow edges <workflowId>
```

```bash
aeontel workflow edges wor_...
```

### `aeontel workflow get-edge`

Get a single workflow edge

```ts
aeontel workflow get-edge <edgeId>
```

```bash
aeontel workflow get-edge edg_...
```

### `aeontel workflow get-node`

Get a single workflow node

```ts
aeontel workflow get-node <nodeId>
```

```bash
aeontel workflow get-node nod_...
```

### `aeontel workflow listeners`

List listeners for a workflow

```ts
aeontel workflow listeners <workflowId>
```

```bash
aeontel workflow listeners wor_...
```

### `aeontel workflow nodes`

List workflow nodes

```ts
aeontel workflow nodes <workflowId>
```

```bash
aeontel workflow nodes wor_...
```

### `aeontel workflow pause-run`

Pause a running workflow

```ts
aeontel workflow pause-run <workflowId> <runId>
```

```bash
aeontel workflow pause-run wor_... run_...
```

### `aeontel workflow restore-listener`

Restore a soft-deleted listener

```ts
aeontel workflow restore-listener <triggerId>
```

```bash
aeontel workflow restore-listener tri_...
```

### `aeontel workflow resume-run`

Resume a paused workflow

```ts
aeontel workflow resume-run <workflowId> <runId>
```

```bash
aeontel workflow resume-run wor_... run_...
```

### `aeontel workflow retry-run`

Retry a failed workflow

```ts
aeontel workflow retry-run <workflowId> <runId>
```

```bash
aeontel workflow retry-run wor_... run_...
```

### `aeontel workflow runs`

List workflow runs

```ts
aeontel workflow runs <workflowId>
```

```bash
aeontel workflow runs wor_...
```

### `aeontel workflow toggle-listener`

Enable or disable a listener

```ts
aeontel workflow toggle-listener <triggerId> [--enable] [--disable]
```

```bash
aeontel workflow toggle-listener tri_...
```