New API features in R2023-01

Features	Description
Task execution filter	A narrower yet more reasonable time range limit has been applied on the task execution filtering to optimize the efficiency of your execution history queries and prevent against misuse of the resources. When setting a time range with the from and the to parameters, the allowed maximum value is 60 days. If no time range is explicitly set, the default value is the last 60 days. Related endpoint: Get available task executions.
OAS CLI generation	The downloads of public API specifications are bug free and ready for a smooth OAS (OpenAPI Specification) CLI generation. Related endpoints: Orchestration, Workspace Permissions and Processing.
Pausing or resuming a task	You can easily read who paused or resumed a task and on which date this operation was performed. Related endpoints: Pause or resume a task.
Simulating promotion runs	The POST /processing/executions/promotions/id endpoint, dedicated to simulating promotions, has been relocated to the Orchestration API category to become POST /orchestration/executables/promotions/id. The old endpoint becomes unavailable. During this migration, some missing artifact version fields are also added in the response of the API call. For further information about the related API endpoints, see New features for API in R2022-09 Information noteNote: If you are using this endpoint on Swagger, for example, on https://api.us.cloud.talend.com/tmc/swagger/swagger-ui.html, the POST executions/promotions/id endpoint for promotion simulation has been deprecated. Use POST /executables/promotions/id instead.
API usability enhancement	A number of discrepancy issues have been fixed for API endpoints to help you efficiently develop your API solutions. Related endpoints: Get Plan details: the PlanPauseDetails attribute is present in the response for all the environments. Create a schedule: use trigger instead of Trigger in the payload. Update Task: version discrepancies have been removed in the response. Create Task, Get available Tasks, and Update Task: in the three endpoints, the format inconsistency of the numeric values used in the context variables has been repaired.
More APIs supporting service accounts	All the project management endpoints, the Observability endpoints, and the smart timeout endpoints now support service account tokens. This means that you can use service accounts to invoke these APIs without having to rely on a user account: Projects Project Authorization Observability Metrics Smart timeout endpoints: Get smart timeout status of tasks Activate the smart timeout on tasks Deactivate the smart timeout on tasks

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 – let us know how we can improve!

Leave your feedback here