Skip to main content
  • New archived content: Talend MDM, Talend Data Catalog 8.0, and Talend 7.3 products reached their end of life in 2024. Their documentation was moved to the Talend Archive page and will no longer receive content updates.
Close announcements banner

Promotion

A new context field has been added to the following promotion related endpoints. This optional field contains the description of the circumstances related to a promotion run. The length of this description must not exceed 255 characters.

Method Endpoint Description Query parameters Body example
POST /executions/promotions Runs a promotion. - The request body could be:
{  
  "executable": "57f64991e4b0b689a64feed0",
  "keepTargetResources": true,
  "keepTargetRunProfiles": true,
  "context": "Free text you add to describe the context for a promotion run",
  "advanced": {
    "artifactId": "57f64991e4b0b689a64feed0",
    "artifactType": "WORKSPACE"
  }
}
GET /executions/promotions/{runId} Gets details of a promotion run. - The response body could be:
{
  "executionId": "7b2b122e-d6b8-42de-b0ba-fa2f0d36306e",
  "startTimestamp": "2022-01-03T04:40:43.130Z",
  "triggerTimestamp": "2022-01-03T04:40:43.130Z",
  "finishTimestamp": "2022-01-03T04:40:43.130Z",
  "userId": "user_id",
  "userType": "HUMAN",
  "promotionId": "string",
  "pipelineId": "string",
  "keepTargetResources": true,
  "keepTargetRunProfiles": true,
  "context": "Free text added to describe the context for a promotion run",
  "advanced": {
    "artifactId": "57f64991e4b0b689a64feed0",
    "artifactType": "WORKSPACE"
  }
...
}

Access these endpoints via https://api.us.cloud.talend.com/tmc/swagger/swagger-ui.html. You'll find a list of the URLs corresponding to each data center in Accessing Talend Cloud applications.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!