Matillion CLI

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.

🔑 API Access RequiredYou 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.

Trigger Matillion Pipeline

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

CLI Command

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 or 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.

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

MATILLION_BASE_URL="https://us1.api.matillion.com"
MATILLION_CLIENT_ID="your_client_id"
MATILLION_CLIENT_SECRET="your_client_secret"

Usage Example

# 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

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 or 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

# 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

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 or 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

# 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

API Keys & Access

GraphQL API

Python SDK

Paradime CLI

Webhooks

Virtual Environments

Trigger Matillion Pipeline

CLI Command

Options

Usage Example

List Matillion Pipelines

CLI Command

Options

Usage Example

List Matillion Projects

CLI Command

Options

Usage Example

Environment Variable Reference

​Trigger Matillion Pipeline

​CLI Command

​Options

​Usage Example

​List Matillion Pipelines

​CLI Command

​Options

​Usage Example

​List Matillion Projects

​CLI Command

​Options

​Usage Example

​Environment Variable Reference

Trigger Matillion Pipeline

CLI Command

Options

Usage Example

List Matillion Pipelines

CLI Command

Options

Usage Example

List Matillion Projects

CLI Command

Options

Usage Example

Environment Variable Reference