Skip to main content
POST
/
transformations
/
run
Python SDK
res = client.transformations.run(transformation_id = 1)

res = client.transformations.run(transformation_id = 1, wait = False)
import asyncio
async def run_transformation():
    res = await client.transformations.run_async(id = 1)
loop = asyncio.get_event_loop()
loop.run_until_complete(run_transformation())
loop.close()
{
  "id": 123,
  "uuid": "<string>",
  "transformationId": 123,
  "transformationExternalId": "<string>",
  "sourceProject": "<string>",
  "destinationProject": "<string>",
  "destination": {
    "type": "assets"
  },
  "conflictMode": "abort",
  "query": "<string>",
  "createdTime": 123,
  "ignoreNullFields": true,
  "status": "Completed",
  "startedTime": 123,
  "finishedTime": 123,
  "lastSeenTime": 123,
  "error": "<string>"
}

Authorizations

Authorization
string
header
required

Access token issued by the CDF project's configured identity provider. Access token must be an OpenID Connect token, and the project must be configured to accept OpenID Connect tokens. Use a header key of 'Authorization' with a value of 'Bearer $accesstoken'. The token can be obtained through any flow supported by the identity provider.

Body

application/json
externalId
string
required

The external ID provided by the client. Must be unique for the resource type.

Maximum string length: 255
Example:

"my.known.id"

nonce
object

Credentials for a CDF session (sessionId, nonce, and project name). These are obtained when you create a session via the Sessions API. See Sessions API documentation for more information.

Response

Response with a single job.

Details for the last finished job of this transformation

id
integer<int32>
required

Job numeric ID.

uuid
string
required

UUID id of the job.

transformationId
integer<int32>
required

ID of the transformation that created this job.

transformationExternalId
string
required

External ID of the transformation that created this job.

sourceProject
string
required

CDF project which is used as source for reading data.

destinationProject
string
required

CDF project which is used as destination for writing data.

destination
object
required

Destination data type.

conflictMode
enum<string>
required

Behavior when the data already exists.upsert - Create or Update,abort - Create and fail when already exists,update - update and fail if it does not exist,delete - delete the matched rows.

Available options:
abort,
delete,
update,
upsert
query
string
required

The SQL query being executed.

createdTime
integer<int64>
required

Time when the job was created: The number of milliseconds since 00:00:00 Thursday, 1 January 1970, Coordinated Universal Time (UTC), minus leap seconds.

ignoreNullFields
boolean
required

How NULL values are handled on updates: ignore or setNull.

status
enum<string>
required

Status of the job at the request time.

Available options:
Completed,
Created,
Failed,
Running
startedTime
integer<int64>

Time when this job started executing: The number of milliseconds since 00:00:00 Thursday, 1 January 1970, Coordinated Universal Time (UTC), minus leap seconds.

finishedTime
integer<int64>

Time when this job finished running: The number of milliseconds since 00:00:00 Thursday, 1 January 1970, Coordinated Universal Time (UTC), minus leap seconds.

lastSeenTime
integer<int64>

Time when this job last registered running: The number of milliseconds since 00:00:00 Thursday, 1 January 1970, Coordinated Universal Time (UTC), minus leap seconds.

error
string

If the job failed, this will be a string describing why. When null, the job did not fail.

Last modified on April 23, 2026