# Migrating API v2.6 to new domains

Talend API endpoints have been progressively and definitely migrated to new business domains following [a new versioning policy](https://api.talend.com/api-versioning-policy/).

Starting from r2024-03, API v2.6 becomes deprecated. Migrate your API requests from API v2.6 to these new domains using the path map presented in the following steps.

## About this task

You can proceed as follows to accomplish the migration:

## Procedure

1. Review your current API workflow to identify Talend Management Console API calls made to v2.6 or earlier versions.
2. Replace existing URI resource paths with the corresponding paths for the new domains, as listed in the table below:

   API endpoint migration mapAPI endpoint migration map
   | First-level resource | v2.6 API URI path | New domain-specific API URI path |
   | --- | --- | --- |
   | Workspace Permissions | /workspaces/{workspaceId}/users/{userId}/permissions<br><br>/security/permissions/batch | /security/workspaces/{workspaceId}/users/{userId}/permissions<br><br>/security/permissions/batch |
   | Workspaces | /workspaces | /orchestration/workspaces |
   | Task Executions | /executions<br><br>/executables/tasks/ | /processing/executions<br><br>/processing/executables/tasks/ |
   | Tasks | /tasks<br><br>/executables/events/search | /orchestration/tasks<br><br>/orchestration/executables/events/search |
   | Schedules | /schedules | /orchestration/schedules |
   | Resources | /resources | /orchestration/resources |
   | Promotion Executions | /executions/promotions | /processing/executions/promotions |
   | Promotions | /promotions | /orchestration/promotions |
   | Projects | /projects | /orchestration/projects |
   | Plan Executions | /executions/plans<br><br>/executables/plans/executions<br><br>/executables/plans/{planId}/executions | /processing/executions/plans<br><br>/processing/executables/plans/executions<br><br>/processing/executables/plans/{planId}/executions |
   | Plans | /executables/plans | /orchestration/executables/plans |
   | Environments | /environments | /orchestration/environments |
   | Connections | /connections | /orchestration/connections |
   | Artifacts | /artifacts | /orchestration/artifacts |
   | Account Subscription | /subscription | /account/subscription |
3. Test new API calls with your personal access token. If successful, proceed to commit your changes.

## What to do next

After the migration, Consider to adopt [service accounts](https://api.talend.com/use-cases/service-accounts/creating-a-service-account/) and [multi-trigger tasks or plans](https://api.talend.com/use-cases/multiple-triggers/use-schedule-to-organize-task-runs/):

* A service account represents a non-human user entity that uses access tokens to authenticate to Talend Cloud and call a Talend API endpoint. This helps enhance and automate your identity and security management.
* A multi-trigger task or plan can have up to 15 time-based triggers, improving schedule maintenance and avoiding duplicate tasks or plans when multiple triggers are necessary.

This is optional but recommended after full migration to the new API endpoints.

Information noteTip: Service accounts are only supported by the domain specific API endpoints. Full migration to these new endpoints is necessary to leverage the benefits of service accounts effectively.