Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.maia.ai/llms.txt

Use this file to discover all available pages before exploring further.

Here you’ll find the 2026 changelog for . Just want to read about new features? Read our New Features blog. For an explanation of minimum version, read version tracks.
May 15, 2026
MCP server

MCP server - New features

Ten new AI Agents tools are now available in the Matillion MCP server, enabling you to create and manage ’ tasks from your AI assistant client:
ToolTypeDescription
create-agent-taskWriteCreate a new task
list-agent-tasksReadList ’ tasks for the account
get-agent-taskReadGet a task’s status, configuration, and pending decisions
get-agent-task-messagesReadGet the message history and events for a task
send-agent-task-messageWriteSend a follow-up message to a running task to grant permissions or update the task configuration
submit-agent-task-decisionsWriteApprove or reject tool calls that are waiting on, and answer pending questions
set-agent-task-permissionsWriteReplace the full list of granted tool permissions for a task
wait-for-agent-taskReadMonitor a task until it reaches a pending decision, terminal state, or timeout
stop-agent-taskWriteStop a task that is currently running
delete-agent-taskWriteDelete a task that has been stopped
Minimum version: All supported versions.
May 14, 2026
Observability

Observability - Improvements

  • The allow list is now enforced on existing schedules. Subsequent pipeline runs will be recorded with a new Forbidden status.
May 13, 2026
API

API - Updated endpoints

This release contains a breaking change. Existing API clients that call this endpoint without the connectionNames query parameter will now receive a 400 Bad Request response.
The Delete environment connection overrides endpoint has been updated for the REST API:
MethodEndpointDescription
DELETE/v1/projects/{projectId}/connections/environment-overridesThe connectionNames query parameter is now required (previously optional). Requests that omit this parameter will return a 400 Bad Request response.
May 8, 2026
Observability, API

Observability - New features

The Your activity page now supports saved views. Save your applied filters as a named view, switch between views from the Saved filters drop-down, and mark one view as your default to load automatically each time you open the page. For more information, read Saved views.Minimum version: All supported versions.

Observability - Improvements

The root cause analysis that provides when a scheduled or API-triggered executed pipeline run fails has been improved. The analysis conducts is more thorough and context-aware, and the analysis report you receive is more detailed and actionable. For more information, read Root cause analysis.Minimum version: All supported versions.

API - Updated endpoints

The following endpoints have been updated for the REST API:
MethodEndpointDescription
POST/v1/projects/{projectId}/connectionsauthType now accepts three additional OAuth values: OAUTH_USER_TOKENS, OAUTH_AUTHORIZATION_CODE, and OAUTH_CLIENT_CRED. For COMPONENT_BASIC connections, the value determines the type of OAuth secret referenced.
PUT/v1/projects/{projectId}/connectionsauthType now accepts three additional OAuth values: OAUTH_USER_TOKENS, OAUTH_AUTHORIZATION_CODE, and OAUTH_CLIENT_CRED.
POST/v1/projects/{projectId}/connections/environment-overridesauthType is now a required field in the request body, accepting GENERIC_SECRET, CLOUD_PROVIDER_SECRET, OAUTH_USER_TOKENS, OAUTH_AUTHORIZATION_CODE, or OAUTH_CLIENT_CRED. The value must match the parent connection’s authType.
POST/v1/projects/{projectId}/environmentsThe connectionOverrides array now accepts up to 200 items when creating an environment (previously limited to 1).
GET/v1/projects/{projectId}/published-pipelinespage and size query parameters are now explicitly typed as integers with documented defaults (page: 0, size: 25) and a maximum of 1000 for size.
May 7, 2026
Streaming

Streaming - New features

  • s now support exporting logs to Matillion’s systems for support. To enable the feature, set the EXPORT_LOGS optional parameter to true. For more information, read Export logs.

Streaming - Improvements

  • Updated the version from 2.116.1 to 2.119.1.
  • s log structure updated to a JSON format.
  • Library updates and security fixes.
May 6, 2026
API

API - New endpoints

The following endpoints have been added to the REST API:AI Agent Tasks
MethodEndpointDescription
GET/v1/ai/agents/tasksList AI agent tasks for the account, optionally filtered by project, branch, or status.
POST/v1/ai/agents/tasksCreate a new AI agent task and start async execution.
GET/v1/ai/agents/tasks/{taskId}Get details of a specific AI agent task, including current status and pending decisions.
DELETE/v1/ai/agents/tasks/{taskId}Permanently delete an AI agent task. The task must not be in RUNNING status.
GET/v1/ai/agents/tasks/{taskId}/messagesGet paginated events for a task.
POST/v1/ai/agents/tasks/{taskId}/messagesSend a follow-up message to a running or stopped task, resuming agent execution.
POST/v1/ai/agents/tasks/{taskId}/decisionsSubmit approval or question-answer decisions for a task awaiting human input.
PUT/v1/ai/agents/tasks/{taskId}/permissionsReplace the full set of granted tool permissions for a task.
POST/v1/ai/agents/tasks/{taskId}/stopRequest that a running task be stopped gracefully.

API - Updated endpoints

The following endpoints have been updated for the REST API:
MethodEndpointDescription
POST/v1/projects/{projectId}/repositoriesRequest body now accepts oneOf CreateGitHubRepositoryRequest or CreateAzureDevOpsRepositoryRequest, adding support for creating Azure DevOps repositories. The provider enum now includes azure-devops alongside github. A new example has been added for an Azure DevOps repository with organization, repositoryId, and tenantId parameters.
GET/v1/consumptionResponse schema updated: the dimensions object now includes an environment field for orchestration and transformation consumption, identifying the environment in which the pipeline ran.
POST/v1/projects/{projectId}/secret-references and related endpointsagentId is no longer a required field on SecretReferenceRequest, AwsSecretReferenceRequest, and AzureSecretReferenceRequest. It remains an optional property on JsonSecretReferenceRequest.
April 28, 2026

Designer - Improvements

can now sample up to 200 rows of data when working on pipelines in to review your data, identify patterns, and troubleshoot transformation steps. For more information about how sample your data, read Sampling data. Minimum version: All supported versions.
April 27, 2026

Designer - New features

Iterator components now support a Stop on condition property, allowing you to stop iterations early when a specific condition is met. This brings iterator behavior in line with . When enabled, a Condition dialog lets you define one or more conditions using a no-code UI, with a Text mode toggle available for writing conditions manually as a JavaScript expression. A Combine conditions property controls whether multiple conditions are evaluated using And or Or logic. For more information, read the documentation for each component:Minimum version: All supported versions.
April 24, 2026

Designer - New features

Connectors:The following new connectors are now available for Snowflake projects, offering full and incremental load options to only fetch new and updated rows of data:Minimum version for both connectors: 11.313.7
April 21, 2026
Maia, API

Maia - Improvements

now supports three regions: US, EU, and Australia:
  • Customers can select Australia as their region at account creation, and trials will run in AU automatically.
  • Hybrid-SaaS Maia runner support is available in the Australia region.

API - Updated endpoints

The following endpoints have been updated for the REST API:
MethodEndpointDescription
GET/v1/consumptionResponse schema updated: examples for results and consumption properties now include more detailed pipeline/project/user information in the dimensions object. Descriptions for pipelineName and projectId updated for clarity.
GET/v1/projects/{projectId}/pipeline-executions/{pipelineExecutionId}Summary updated to “Pipeline Execution Details”. Description expanded to clarify the endpoint returns full execution details. 200 response description updated for accuracy.
POST/v1/projects/{projectId}/pipeline-executionsDescription expanded to clarify asynchronous execution, artifact versioning, agent selection, concurrency control, and variable overrides. Request body schema updated: scalarVariables and gridVariables descriptions now clarify override behavior.
POST/v1/projects/{projectId}/schedulesRequest body schema updated: pipeline.scalarVariables and pipeline.gridVariables descriptions now clarify override behavior for scheduled pipeline executions.
April 20, 2026
Maia, API

Maia - Improvements

User management and roles improvements:
  • Redesigned user management screen with sorting, filtering, and paging for easier navigation.
  • Simplified account-level roles to make permissions easier to understand.
  • For users only, project roles can now be assigned during user invitation, so access is ready on acceptance.
  • For users only, a new Roles section shows clear permissions across account, project, and environment levels.

API - New endpoint

The following endpoint has been added for the REST API:
MethodEndpointDescription
GET/v1/projects/{projectId}/pipeline-executions/{pipelineExecutionId}/statusReturns the current status of a pipeline execution.
April 16, 2026
API

API - Updated endpoints

The following endpoints have been updated for the REST API:
MethodEndpointDescription
GET/v1/consumptionResponse 200: results.consumption.credits example changed from ‘28.4’ (string) to 28.4 (number).
GET/v1/pipeline-executionsResponse 200: Added enum value SCHEDULE_RUN_NOW to results.trigger updated results.user description. Response 401/403: Description changes.
POST/v1/projects/{projectId}/pipeline-executionsCorrected response descriptions (401 Unauthorized, 403 Forbidden).
GET/v1/projects/{projectId}/pipeline-executions/{pipelineExecutionId}Description updated to recommend getExecutionStatusOnly. Response 200: Added enum value SCHEDULE_RUN_NOW to trigger; updated user description. Response 401/403: Description changes.
PATCH/v1/projects/{projectId}/pipeline-executions/{pipelineExecutionId}Corrected response descriptions (401 Unauthorized, 403 Forbidden).
GET/v1/projects/{projectId}/pipeline-executions/{pipelineExecutionId}/stepsCorrected response descriptions (401 Unauthorized, 403 Forbidden).
POST/v1/projects/{projectId}/reviewsRequest body: filePaths property type can now be null (previously required an array).
April 10, 2026
Connectors, API

Connectors - Update

Matillion’s own Flex connector has been renamed from Data Productivity Cloud to . The connector’s functionality and configuration remain unchanged.

API - New endpoints

The following endpoints have been added to the REST API:Shared Pipeline Artifacts
MethodEndpointDescription
GET/v1/shared-pipelinesList all published shared pipelines across the account.
GET/v1/shared-pipelines/artifactsList published artifact versions with optional filters.
GET/v1/shared-pipelines/artifacts/detailsGet artifact metadata and the pipelines inside a version.
POST/v1/shared-pipelines/artifactsPublish a new artifact version.
PATCH/v1/shared-pipelines/artifactsEnable or disable a specific artifact version.
April 9, 2026
Components, API

Maia - Improvements

Components
  • The Python Script component has been updated to use Python 3.12, ahead of the planned Python 3.10 end-of-life in October 2026. For further details, read this Tech note. Minimum version: 11.281.0

API - New endpoints and improvements

The following endpoints have been added to the REST API:Agents
MethodEndpointDescription
GET/v1/agents/releasesGet agent track history.
The following endpoints have been updated:
  • The gke deployment type is now available for both Maia and Streaming agent types for POST /v1/agents (previously only available for streaming agents).
  • A new FORBIDDEN status value is now available for the status filter parameter of GET /v1/pipeline-executions.
April 1, 2026
Streaming

Streaming - New features

A public Terraform provider is now available for s and Streaming pipelines, enabling you to create and configure s and pipelines programmatically at scale using Terraform scripts. For more information, read Deploy with Terraform.
March 31, 2026
Billing

Billing - New features

A Premium category has been introduced for selected connectors. These connectors require an additional subscription regardless of your current plan. For more information, contact your Matillion account representative.Minimum version: All supported versions.
March 25, 2026

Components - New features

The Data Cleanse component is now available for transformation pipelines in Amazon Redshift projects. This component provides data profiling and cleansing capabilities to help you identify and resolve data quality issues in your datasets.Minimum version: 11.147.0

Observability - New features

Added Webhook as a delivery channel for platform notifications, allowing users to route pipeline failure alerts to services such as Microsoft Teams, ServiceNow, or any internal tooling that accepts a webhook. Notifications can be configured at the project or environment level, removing the need to build notification logic into individual pipelines or rely solely on email alerts. For more information, read Pipeline notifications.Minimum version: All supported versions.

Shared pipelines - New features and improvements

Updated the shared pipeline experience. You can now configure scalar and grid variables in the Share pipeline dialog, including setting display names, marking variables as required, and reordering them. Variable descriptions are now visible when configuring the pipeline, and the Run Shared Pipeline component now provides clearer guidance on required and optional inputs.Minimum version: All supported versions.
March 24, 2026
Observability

Observability - New features

You can now re-run pipelines directly from the Pipeline run history without opening . You can re-run an entire pipeline or re-run execution at the step level using dedicated icons to Run from step (re-runs that step and all downstream steps) or Run only step (re-runs that step in isolation), with each action creating a new pipeline execution.Minimum version: All supported versions.
March 23, 2026

API - Improvements

The following endpoints have been updated:
  • The Git-Provider-Access-Token header parameter is now optional for POST /v1/projects/{projectId}/repositories.

Maia - New features

The IP allow list enables account access to be restricted to specific IP addresses or IP ranges.Minimum version: All supported versions.
March 20, 2026

Connectors - New features and improvements

Added a new Column mapping parameter to Flex connectors and custom connectors. This parameter allows you to select fields from an unstructured dataset to load as individual columns. As a result, you don’t need to use an Extract Nested Data component to unpack data into columns.Minimum version: 11.234.0

API - New endpoints and improvements

The following endpoints have been added to the REST API:Pipeline Quality Review
MethodEndpointDescription
POST/v1/projects/{projectId}/reviewsReview pipelines against quality rules.
Project Variables
MethodEndpointDescription
GET/v1/projects/{projectId}/variablesRetrieve project variables.
POST/v1/projects/{projectId}/variablesCreate a project variable.
DELETE/v1/projects/{projectId}/variables/{variableName}Delete a project variable.
PATCH/v1/projects/{projectId}/variables/{variableName}Update a project variable.
Project Variable Environment Overrides
MethodEndpointDescription
GET/v1/projects/{projectId}/variables/{variableName}/environment-overridesRetrieve environment-level overrides for a project variable.
POST/v1/projects/{projectId}/variables/{variableName}/environment-overridesCreate an environment-level override for a project variable.
DELETE/v1/projects/{projectId}/variables/{variableName}/environment-overrides/{environmentName}Delete an environment-level override for a project variable.
The following endpoints have been updated:
  • Added a new Full SaaS Agent on Snowflake example to the request body for POST /v1/projects.
March 19, 2026

Components - New features

Added a new Allow inherit project defaults toggle to control whether an environment inherits project-level variable values by default or requires manual overrides. For more information on managing these configurations, read Environments.Minimum version: All supported versions.

Connectors - New features

Added a new Oracle Load connector, which offers Full and Incremental load options.Minimum version: 11.134.0

Maia - Improvements

Users with the Contributor role on a project can now create and modify project variables, but can’t delete them. For more information, read Project roles.Minimum version: All supported versions.
March 18, 2026
Observability

Observability - Improvements

Added a new table to the Audit event types section of the Audit Service page to list the event types supported by the Audit API. Also updated the Account table to include additional event types.Minimum version: All supported versions.
March 17, 2026

Designer - New features

New system variables for environment defaults have been added, allowing you to reference default connection values in your pipelines. These variables provide access to the default database, schema, warehouse, role, catalog, compute resource, S3 bucket, and application configured for the environment. For more information, read System variables.Minimum version: 11.217.1
March 16, 2026

Components - New features

The following Load components are now available for Databricks:Minimum version: 11.154.0
March 11, 2026

Observability - Improvements

Added a new table to the Audit event types section of the Audit Service page that lists the Project event type supported by the Audit API.Minimum version: All supported versions.

Maia - Improvements

Updated the information shown when viewing artifacts. You can now see the Git hash of the commit that created the artifact, and the name of the user who created the artifact.Minimum version: All supported versions.

Streaming - Improvements

  • Updated the version from 2.115.1 to 2.116.1.
  • Library updates and security fixes.
  • Added a new advanced property called matillion.snowflake.maintain-primary-keys (default: false). When enabled, the will mirror primary key constraints from your source database onto the destination Snowflake tables. This includes table creation and schema changes. If changes to the primary key of a table are required, writes to the source table must be stopped and outstanding changes allowed to flow through to Snowflake before stopping the pipeline. Once the primary key update is complete, the pipeline can be restarted. To enable this feature, add the following to your Streaming pipeline’s advanced properties:
    • matillion.snowflake.maintain-primary-keys = true
This is a Snowflake-specific property and has no effect on other target types. Snowflake primary keys are unenforced (informational only), but they can be useful for query optimization hints and downstream tooling that reads table metadata.
March 9, 2026
Observability, UI, API

Observability - Improvements

The Your activity page that displays the pipeline run history has been updated to improve visibility and make troubleshooting faster. The update simplifies the run history view and adds new information to help you quickly understand pipeline runs and identify issues during investigations. For more information, read Pipeline run history.The Audit service now records audit events for project connections and environment connections. Project connection events are produced for SSH tunnels, OAuths, and secret definitions. Environment connection events are produced for OAuths and secret definitions.Minimum version: All supported versions.

UI - New features and improvements

  • Added support for environment-level secrets and OAuth credentials, allowing you to manage secrets and OAuth credentials at the environment level for more granular control and simplified cross-environment credential management. For more information, read Configure values and overrides.
  • You can now edit existing secrets and OAuths, making it easier to rotate credentials.
Minimum version: All supported versions.

API - New endpoints and improvements

Credential management has been simplified into a single API endpoint for connections.The following endpoints have been added to the REST API:Connections
MethodEndpointDescription
DELETE/v1/projects/{projectId}/connectionsDelete a project connection by name.
GET/v1/projects/{projectId}/connectionsRetrieve a page of project connections, optionally filtered by parameters.
POST/v1/projects/{projectId}/connectionsCreate a new project connection.
PUT/v1/projects/{projectId}/connectionsUpdate an existing project connection by name.
DELETE/v1/projects/{projectId}/connections/environment-overridesDelete environment connection overrides.
GET/v1/projects/{projectId}/connections/environment-overridesRetrieve a page of connection overrides which apply in a specific environment.
POST/v1/projects/{projectId}/connections/environment-overridesCreate or update an environment connection override.
The following endpoints have been updated:
  • Added a new enum value of SKIPPED to the status query parameter for GET /v1/pipeline-executions.
March 6, 2026

Connectors - New features

Microsoft Exchange has been added as a new source to the Data Transfer component. This enables users to transfer attachments from Exchange email messages and calendar events using OAuth-based authentication.Minimum version: 11.183.0
March 3, 2026

API - New endpoints

The following endpoint has been added to the REST API:Secrets
MethodEndpointDescription
POST/v1/secrets/{agentId}/secret-valueSet a secret value for a .

Connectors - New features

Added a new Sybase ASE Load connector, which offers Full and Incremental Load options. We recommend using this connector instead of using the Database Query component to connect to Sybase ASE.Minimum version: 11.191.2
March 2, 2026

Maia AI Agents - New features

can now notify you when they finish processing or require your input. This means you can prompt , then switch to another task, and return as soon as have finished working on your prompt. For more information, read Background notifications.Minimum version: All supported versions.

GitHub integration - Improvements

The Matillion App for GitHub (BYOG) now requests read and write access to GitHub Actions workflow files. This enables to update and manage workflow files (.github/workflows/) in connected repositories as part of GitHub pipeline management.Minimum version: All supported versions.

Pipeline observability - Improvements

In the Fix with Maia dialog, use contextual awareness of the executed pipeline’s codebase and history to suggest the most relevant branch based on commit and publish history, and automatically select the environment where the failure occurred. For more information, read assisted - intelligent pipeline recovery.Minimum version: All supported versions.
February 27, 2026

Components - New features

A new Warehouse data tab is available when you click the Add component icon on the canvas, allowing you to directly add data from your warehouse as a Table Input component in transformation pipelines.Minimum version: All supported versions.
February 26, 2026

Pipeline observability - New features

  • The Pipeline run history page now displays Skipped pipeline runs when a schedule has Allow concurrent schedule runs disabled and a new execution is triggered while a previous run for the same schedule is still in progress. Skipped runs are recorded with an amber status indicator.
  • You can now search pipeline runs by Execution ID, in addition to pipeline name.
Minimum version: All supported versions.

Maia AI Agents - Improvements

now support workload conversion from Apache NiFi, IBM DataStage, WhereScape, and Oracle ODI, enabling you to convert existing ETL/ELT workloads into production-ready pipelines.Minimum version: All supported versions.
February 23, 2026

Maia AI Agents - New features

  • can now ask questions in your conversations to better understand your prompts.
  • When approving tool permissions in your chats with , you can now provide a reason when declining permissions. This can help to better understand your prompt or to adjust their approach.
  • now dynamically update your conversation titles to accurately reflect the topic of discussion, making it easier to understand your conversation history and return to previous conversations.
Minimum version: All supported versions.
February 19, 2026

Components - New features

A Data Cleanse component is now available for transformation pipelines in Snowflake projects. This component provides data profiling and cleansing capabilities to help you identify and resolve data quality issues in your datasets.Minimum version: 11.147.0
February 12, 2026
Streaming

Streaming - Improvements

  • Updated the version from 2.113.75 to 2.115.1.
  • Db2 for IBM i: Added Heartbeat functionality.
  • Library updates and security fixes.
February 10, 2026

Maia AI Agents - New features

You can now create skills to help respond to your prompts more effectively. Skills are sets of reusable instructions that are particularly useful if you often give repetitive prompts. They provide guidelines and standards for to follow, which means you don’t need to include this information in every prompt.Minimum version: All supported versions.

Pipeline quality review - New features

  • You can now automatically fix selected pipeline quality rule violations using Fix with Maia from the Review results panel, helping resolve common issues such as component naming, missing start or end components, and unused components.
  • Added a new Review all pipelines option to the canvas. This lets you review all orchestration and transformation pipelines in a branch in a single action, making it easier to identify pipeline quality issues across your branch.
  • You can now choose to run pipeline quality checks from the Commit changes dialog by enabling the review option before committing. When enabled, commits are blocked if rule violations with an error enforcement level are detected, while commits with warnings or no issues proceed successfully.
Minimum version: All supported versions.

API - Improvements

The following endpoints have been updated:
  • Added a [FULL_SAAS] enum value to property agentDeploymentType for POST /v1/projects.
  • Added a 403 response to DELETE /v1/projects/{projectId}/secret-references/{secretReferenceName}.
February 9, 2026
Billing

Consumption Dashboard - New features

A new Additional Users tab is now available in the Consumption Dashboard, providing visibility into individual user credit charges incurred during the current billing period.Minimum version: All supported versions.
February 4, 2026

Connectors - Improvements

A new OAuth 2.0 Client Credentials option is now available in the Authentication type drop-down menu for the Salesforce Load connector.Minimum version: 11.67.0
January 30, 2026

Maia runners - New features

Hybrid SaaS s can now export logs to Matillion’s systems for support purposes. This facilitates faster response if support is needed. This feature can be enabled or disabled in the settings. For more information, read Export logs.Minimum version: 11.46.1
January 27, 2026

Connectors - Improvements

Added a new property to the Workday Load component. The new Advanced Mode Type property lets you choose whether to use an SQL query or SOAP operation to fetch your data.Minimum version: 11.120.0
January 21, 2026

Maia AI Agents - New features

Convert Workloads has been added to . This new feature allows users to leverage ’ intelligence to seamlessly convert existing ETL/ELT workloads from other platforms into production-ready pipelines.Minimum version: All supported versions.
January 15, 2026
API

API - Improvements

The following endpoint has been updated:
  • Added the pipelineName field to the dimensions object of the response for GET /v1/consumption. Applies to orchestration and transformation pipeline credit usage types.
January 14, 2026

Pipeline observability - New features

Added Slack as a delivery channel for platform notifications, allowing users to receive pipeline failure alerts directly in Slack. Notifications can be configured at the project or environment level, removing the need to build notification logic into individual pipelines or rely solely on email alerts. For more information, read Pipeline notifications.Minimum version: All supported versions.
January 13, 2026

Connectors - New features

Added an Amazon Redshift Load connector for Snowflake projects. This connector offers Incremental Load and we recommend using it instead of the Database Query component to connect to Amazon Redshift.Minimum version: 11.94.0

Roles - Improvements

The Runner role is now renamed to Operator. This role can now modify environment-level overrides for project-level variables, secret definitions, and OAuths. For more information, read Environment roles.Minimum version: All supported versions.
January 6, 2026

Maia - New features

Fix with Maia has been added to Root Cause Analysis. This new feature allows users to leverage Maia’s capabilities to automatically identify and fix issues in their scheduled or API-executed pipeline, reducing downtime and improving efficiency.Minimum version: All supported versions.

Connectors - New features

Added a new HubSpot Load connector, which uses the HubSpot API to retrieve your data. This connector offers Full and Incremental Load options.Minimum version: 11.72.0