---
title: "Trigger plan execution"
method: POST
path: "/transformations/v1/plans/{planUrn}/execute"
tags: ["Transformation Plans"]
---

# Trigger plan execution

`POST /transformations/v1/plans/{planUrn}/execute`

## Request

- Base URL: `https://your-environment.ataccama.one/api`
- URL: `https://your-environment.ataccama.one/api/transformations/v1/plans/{planUrn}/execute`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/docs/transformations/v1/plans/:planUrn/execute/post.ts> (a function with typed inputs; its response is checked against the schema)

Initiate an asynchronous execution of a published transformation plan.

The execution runs asynchronously: the transformation plan starts executing in the background.
Use the `workflowUrn` from the response to track execution status through the Workflows endpoints, or monitor its progress in the **Processing Center** in Ataccama ONE.

Plans must be in `PUBLISHED` state to be executed via API.
Triggering multiple executions of the same plan might run them concurrently unless the plan has built-in locking.

## Path parameters

- `planUrn` string, uri, required: A URN identifying a transformation plan resource in the Transformations API. Format: urn:ata:{tenant}:transformations:plan:{uuid} Example: urn:ata:acme-corp:transformations:plan:01924b84-6f7e-7c0c-8f9d-3a2b4c5d6e7f.

## Response `202`

Execution initiated successfully.

- PlanExecution: Represents an execution instance of a transformation plan.
  - `workflowUrn` string, uri, required: A URN identifying a processing workflow. Format: urn:ata:{tenant}:processing:workflow:{uuid} Example: urn:ata:acme-corp:processing:workflow:123e4567-e89b-12d3-a456-426614174000.
  - `planUrn` string, uri, required: A URN identifying a transformation plan resource in the Transformations API. Format: urn:ata:{tenant}:transformations:plan:{uuid} Example: urn:ata:acme-corp:transformations:plan:01924b84-6f7e-7c0c-8f9d-3a2b4c5d6e7f.
  - `status` string, required: @ExtensibleEnum Status of a plan execution.
  - `createdAt` string, date-time, required: When the execution started.

## Other responses

- `400`: Bad request. The request parameters or body are invalid.
- `403`: Forbidden. You do not have permission to access the requested resource.
- `404`: Not found. The requested resource does not exist.
- `500`: Internal server error. An unexpected error occurred; retry the request later.

---

[API](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api.md) - [All operations](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/revisions/46f16e0487f8?raw)