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

# Matillion CLI

> Trigger Matillion Data Productivity Cloud pipeline runs and list projects and pipelines from Paradime Bolt using the paradime run matillion CLI commands.

The Paradime SDK provides CLI commands to interact with Matillion Data Productivity Cloud, allowing you to trigger pipeline executions and list available pipelines and projects.

<Warning>
  🔑 **API Access Required**

  You will need Matillion Data Productivity Cloud OAuth credentials to use these commands:

  * **Base URL**: Your Matillion DPC API base URL (e.g. `https://us1.api.matillion.com` or `https://eu1.api.matillion.com`).
  * **Client ID** and **Client Secret**: Generate these in your Matillion account settings.
</Warning>

## Trigger Matillion Pipeline

Trigger execution for one or more Matillion Data Productivity Cloud pipelines with optional wait-for-completion monitoring.

### CLI Command

```bash theme={"system"}
paradime run matillion-pipeline
```

#### Options

| Flag                   | Type              | Description                                                                                                                                                                                                                         |
| ---------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--base-url`           | Required, TEXT    | Your Matillion DPC API base URL (e.g., [https://us1.api.matillion.com](https://us1.api.matillion.com) or [https://eu1.api.matillion.com](https://eu1.api.matillion.com)). Can be set via `MATILLION_BASE_URL` environment variable. |
| `--client-id`          | Required, TEXT    | Your Matillion OAuth client ID. Generate this in your Matillion account settings. Can be set via `MATILLION_CLIENT_ID` environment variable.                                                                                        |
| `--client-secret`      | Required, TEXT    | Your Matillion OAuth client secret. Generate this in your Matillion account settings. Can be set via `MATILLION_CLIENT_SECRET` environment variable.                                                                                |
| `--project-names`      | Required, TEXT    | The Matillion project name.                                                                                                                                                                                                         |
| `--pipeline-names`     | Required, TEXT    | Comma-separated pipeline name(s) to execute.                                                                                                                                                                                        |
| `--environment`        | Required, TEXT    | The Matillion environment name to execute the pipeline in.                                                                                                                                                                          |
| `--wait` / `--no-wait` | Optional, Flag    | Wait for pipeline executions to complete before returning. Default: `--wait`. Can be set via `MATILLION_PIPELINE_WAIT` environment variable.                                                                                        |
| `--timeout`            | Optional, INTEGER | Maximum time to wait in minutes. Default: 1440 (24 hours). Can be set via `MATILLION_PIPELINE_TIMEOUT` environment variable.                                                                                                        |
| `--json`               | Optional, Flag    | Output results as JSON. Default: `False`.                                                                                                                                                                                           |
| `--help`               | Optional, Flag    | Show the help message and exit.                                                                                                                                                                                                     |

<Info>
  **Recommended Setup**

  For security and convenience, set your Matillion credentials as environment variables:

  ```bash theme={"system"}
  MATILLION_BASE_URL="https://us1.api.matillion.com"
  MATILLION_CLIENT_ID="your_client_id"
  MATILLION_CLIENT_SECRET="your_client_secret"
  ```
</Info>

### Usage Example

```bash theme={"system"}
# Trigger one or more pipelines (using environment variables)
paradime run matillion-pipeline \
  --project-names "analytics_project" \
  --pipeline-names "load_orders,transform_orders" \
  --environment "production"
```

## List Matillion Pipelines

List all available Matillion Data Productivity Cloud published pipelines for a project and environment.

### CLI Command

```bash theme={"system"}
paradime run matillion-list-pipelines
```

#### Options

| Flag              | Type           | Description                                                                                                                                                                                                                         |
| ----------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--base-url`      | Required, TEXT | Your Matillion DPC API base URL (e.g., [https://us1.api.matillion.com](https://us1.api.matillion.com) or [https://eu1.api.matillion.com](https://eu1.api.matillion.com)). Can be set via `MATILLION_BASE_URL` environment variable. |
| `--client-id`     | Required, TEXT | Your Matillion OAuth client ID. Generate this in your Matillion account settings. Can be set via `MATILLION_CLIENT_ID` environment variable.                                                                                        |
| `--client-secret` | Required, TEXT | Your Matillion OAuth client secret. Generate this in your Matillion account settings. Can be set via `MATILLION_CLIENT_SECRET` environment variable.                                                                                |
| `--project-name`  | Required, TEXT | The Matillion project name.                                                                                                                                                                                                         |
| `--environment`   | Required, TEXT | The Matillion environment name to filter pipelines by.                                                                                                                                                                              |
| `--json`          | Optional, Flag | Output results as JSON. Default: `False`.                                                                                                                                                                                           |
| `--help`          | Optional, Flag | Show the help message and exit.                                                                                                                                                                                                     |

### Usage Example

```bash theme={"system"}
# List published pipelines for a project and environment
paradime run matillion-list-pipelines \
  --project-name "analytics_project" \
  --environment "production"
```

## List Matillion Projects

List all available Matillion Data Productivity Cloud projects.

### CLI Command

```bash theme={"system"}
paradime run matillion-list-projects
```

#### Options

| Flag              | Type           | Description                                                                                                                                                                                                                         |
| ----------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--base-url`      | Required, TEXT | Your Matillion DPC API base URL (e.g., [https://us1.api.matillion.com](https://us1.api.matillion.com) or [https://eu1.api.matillion.com](https://eu1.api.matillion.com)). Can be set via `MATILLION_BASE_URL` environment variable. |
| `--client-id`     | Required, TEXT | Your Matillion OAuth client ID. Generate this in your Matillion account settings. Can be set via `MATILLION_CLIENT_ID` environment variable.                                                                                        |
| `--client-secret` | Required, TEXT | Your Matillion OAuth client secret. Generate this in your Matillion account settings. Can be set via `MATILLION_CLIENT_SECRET` environment variable.                                                                                |
| `--json`          | Optional, Flag | Output results as JSON. Default: `False`.                                                                                                                                                                                           |
| `--help`          | Optional, Flag | Show the help message and exit.                                                                                                                                                                                                     |

### Usage Example

```bash theme={"system"}
# List all Matillion projects
paradime run matillion-list-projects
```

## Environment Variable Reference

| Environment Variable         | Description                                         |
| ---------------------------- | --------------------------------------------------- |
| `MATILLION_BASE_URL`         | Your Matillion DPC API base URL                     |
| `MATILLION_CLIENT_ID`        | Your Matillion OAuth client ID                      |
| `MATILLION_CLIENT_SECRET`    | Your Matillion OAuth client secret                  |
| `MATILLION_PIPELINE_WAIT`    | Whether to wait for pipeline executions to complete |
| `MATILLION_PIPELINE_TIMEOUT` | Maximum time to wait in minutes                     |


## Related topics

- [Bolt CLI](/developers/paradime-cli/bolt-cli.md)
- [Paradime CLI](/developers/paradime-cli/index.md)
- [Catalog CLI](/developers/paradime-cli/catalog-cli.md)
- [Hightouch CLI](/developers/paradime-cli/hightouch-cli.md)