> ## 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. # Execute Published Pipeline > Triggers the asynchronous execution of a named, published pipeline within the specified project. The pipeline must be published to the target environment before it can be executed. On success, returns a `pipelineExecutionId` that can be used to track or query the execution status. **Key behaviours:** * By default, the latest published version of the pipeline is executed. Use `versionName` to target a specific artifact version. * If no `agentId` is provided, the default agent configured for the target environment is used. * Use `executionTag` to control concurrency — only one execution per tag is permitted to run at a time within a given environment. A `409 Conflict` is returned if an execution with the same tag is already in progress. * Runtime variable values can be overridden per-execution using `scalarVariables` (key-value pairs) or `gridVariables` (two-dimensional string arrays), without modifying the published pipeline definition. * A `410 Gone` is returned if the pipeline has been disabled. ## OpenAPI ````yaml /openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/pipeline-executions openapi: 3.1.0 info: title: Maia Public REST API version: '1.0' servers: - description: EU1 url: https://eu1.api.matillion.com/dpc - description: US1 url: https://us1.api.matillion.com/dpc security: - bearerAuth: [] tags: - description: Manage Schedules name: Schedules - description: Manage Connections name: Connections - description: Operations for managing Project Variables name: Project Variables - description: Manage Pipelines name: Pipelines - description: Review pipelines against quality rules name: Pipeline Quality Review - description: Execute tests within a project name: Test Execution - description: Manage your AI agent tasks name: AI Agent Tasks - description: SCIM endpoints for user/group permission management name: Directory Integration - description: Publish shared pipeline artifacts name: Shared Pipeline Artifacts - description: Manage Repositories name: Repositories - description: Report on Credit Consumption name: Consumption - description: Manage Artifacts name: Artifacts - description: Operations for data lineage and governance name: Data Lineage - description: Manage Streaming Pipelines name: Streaming Pipelines - description: Execute a pipeline name: Pipeline Execution - description: '' name: Environments - description: '' name: Projects - description: Manage Agents name: Agents - description: Operations for managing Environment-level Overrides of Project Variables name: Project Variable Environment Overrides - description: Query audit events name: Audit Events - description: Connector Profiles name: Connectors paths: /v1/projects/{projectId}/pipeline-executions: post: tags: - Pipeline Execution summary: Execute Published Pipeline description: >- Triggers the asynchronous execution of a named, published pipeline within the specified project. The pipeline must be published to the target environment before it can be executed. On success, returns a `pipelineExecutionId` that can be used to track or query the execution status. **Key behaviours:** * By default, the latest published version of the pipeline is executed. Use `versionName` to target a specific artifact version. * If no `agentId` is provided, the default agent configured for the target environment is used. * Use `executionTag` to control concurrency — only one execution per tag is permitted to run at a time within a given environment. A `409 Conflict` is returned if an execution with the same tag is already in progress. * Runtime variable values can be overridden per-execution using `scalarVariables` (key-value pairs) or `gridVariables` (two-dimensional string arrays), without modifying the published pipeline definition. * A `410 Gone` is returned if the pipeline has been disabled. operationId: executePipeline parameters: - in: path name: projectId required: true schema: type: string format: uuid requestBody: content: application/json: examples: Execution Request: description: Execution Request value: pipelineName: Pipeline 1 environmentName: Dev Environment Execution Request With Optional Agent: description: Execution Request With Optional Agent value: pipelineName: Dev Pipeline environmentName: Dev Environment agentId: 3fa85f64-5717-4562-b3fc-2c963f66afa6 Execution Request With Optional Execution Tag: description: Execution Request With Optional Execution Tag value: pipelineName: Dev Pipeline environmentName: Dev Environment executionTag: myExecutionTag Execution Request With Optional Version Name: description: Execution Request With Optional Version Name value: pipelineName: Dev Pipeline environmentName: Dev Environment versionName: 1.1.1 Execution Request With Optional variable overrides: description: Execution Request With Optional variable overrides value: pipelineName: Dev Pipeline environmentName: Dev Environment scalarVariables: var1: val1 var2: val2 gridVariables: grid1: - - col1 - col2 - col3 - - col1a - col2a - col3a schema: $ref: '#/components/schemas/PipelineExecutionRequest' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/PipelineExecutionResponse' description: Pipeline executed '400': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Invalid request '401': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Unauthorized '403': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Forbidden '404': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Pipelines not Found '409': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Conflict, concurrent pipeline running for execution tag '410': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Pipeline has been disabled '500': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Unexpected error occurred '504': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Gateway timeout components: schemas: PipelineExecutionRequest: type: object properties: agentId: type: string description: >- Optional agentId to execute the pipeline. If not specified the default agent for the provided environment will be used example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 environmentName: type: string description: Environment pipeline is published to example: Dev Env maxLength: 255 minLength: 0 executionTag: type: string description: >- Optional execution tag, this allows control of pipeline execution concurrency. Only 1 pipeline execution is allowed to run per execution tag in a given environment. example: tag1 gridVariables: type: object additionalProperties: type: array items: type: array items: type: string description: >- Optional map of grid variable names to two-dimensional string arrays, used to override grid variable values for this execution without modifying the published pipeline definition pipelineName: type: string description: Name of the pipeline to execute example: My pipeline minLength: 1 scalarVariables: type: object additionalProperties: type: string description: >- Optional map of scalar variable names to their override values for this execution, without modifying the published pipeline definition versionName: type: string description: >- Optional artifact version name of the pipeline to execute. If not specified the latest version will be executed example: 1.1.0 required: - environmentName - pipelineName PipelineExecutionResponse: type: object properties: pipelineExecutionId: type: string format: uuid description: Identifier of executing pipeline example: 1398aa31-af57-4a6a-9752-27c2e8556c3f ProblemDetail: type: object properties: detail: type: string instance: type: string status: type: integer format: int32 title: type: string type: type: string format: uri violations: type: array items: type: string securitySchemes: bearerAuth: bearerFormat: JWT description: a valid bearer token scheme: bearer type: http ````