ATataccama
Transformation Plans

Trigger plan execution

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.

post/transformations/v1/plans/{planUrn}/execute

Request

Path parameters

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

Example:urn:ata:acme-corp:transformations:plan:01924b84-6f7e-7c0c-8f9d-3a2b4c5d6e7f

URN identifier of the transformation plan to execute. To find a plan URN in Ataccama ONE, go to Data quality > Data transformations and select the plan; the UUID part of the URN is in the URL.

Response

Execution initiated successfully.

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

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

statusstring required

@ExtensibleEnum Status of a plan execution.

createdAtstring date-time required

When the execution started.

Example response

{
  "workflowUrn": "urn:ata:acme-corp:processing:workflow:123e4567-e89b-12d3-a456-426614174000",
  "planUrn": "urn:ata:acme-corp:transformations:plan:01924b84-6f7e-7c0c-8f9d-3a2b4c5d6e7f",
  "status": "RUNNING",
  "createdAt": "2025-01-15T10:30:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.