Service accounts - Cloud

Talend Cloud Release Notes

Version
Cloud
Language
English (United States)
Product
Talend Cloud
Module
Talend API Designer
Talend API Tester
Talend Data Inventory
Talend Data Preparation
Talend Data Stewardship
Talend Management Console
Talend Pipeline Designer
Content
Installation and Upgrade
Release Notes

A service account represents a non-human user entity that uses access tokens to authenticate to Talend Cloud and call a Talend service.

With service accounts, you are enabled to use the OAuth2 Client Credentials Flow for accessing Talend Cloud APIs.

The number of service accounts you can create depends on the number of Talend Cloud admin add-ons specified in your license. Each admin add-on allows you to create 3 service accounts. If you need more service accounts and thus more admin add-ons, contact your sales representative.

Service account endpoints

The account to be used to issue these API calls must have the Service Accounts - Manage permission or the Security Administrator role. The ID of the Service Accounts - Manage permission is TMC_SERVICE_ACCOUNT_MANAGEMENT.

Note that service accounts are supported only by the version-agnostic endpoints that are categorized in these new domains. It is recommended to migrate your version-related API requests to these new endpoints.

Operations Methods Resources
Retrieving a specific service account GET

/account/service-accounts/<id>

Update a specific service account PUT

/account/service-accounts/<id>

Delete a specific service account DELETE /account/service-accounts/<id>
Get a list of the existing service accounts GET /account/service-accounts
Create a service account POST /account/service-accounts
Get the total number of service accounts already created GET /account/service-accounts/count
Get the permissions available for granting to service accounts GET /account/service-accounts/permissions

Access these endpoints via https://api.talend.com/apis/service-accounts/2021-03/ and related use cases at https://api.talend.com/use-cases/service-accounts/.