Setting workspace permissions for a user

Setting workspace permissions for a user - Cloud

Talend Cloud APIs User Guide

Version

Cloud

Language

English

Product

Talend Cloud

Module

Talend API Designer

Talend API Tester

Talend Data Preparation

Talend Data Stewardship

Talend Management Console

Content

Design and Development > Designing APIs

Design and Development > Testing APIs

You can give users permissions to manage or view objects, or allow access to engines in different workspaces.

If you need to assign workspace permissions to a service account, see Assigning workspace permissions to a service account.

You must have Environment Administrator role in Talend Cloud Management Console.
You must know the IDs of the workspace and user for which your are setting the permissions.

You can access the Management Console API via https://api.talend.com/apis/. You'll find a list of the URLs corresponding to each data center in Talend Cloud regions and URLs.

Use the GET /security/workspaces/{workspaceId}/users/{userId}/permissions endpoint to read the current permissions of the user for the selected workspace.
Example
```
GET https://api.us.cloud.talend.com/security/workspaces/7a35e78eaea645620e47f826/users/d13404b5-e9nc-4g5f-9904-a5f0dc287fb0/permissions
```
If you are assigning permissions to a user that did not have any permissions on the specified workspace, use the POST /security/workspaces/{workspaceId}/users/{userId}/permissions endpoint and add the permission(s) in the body of the request.
Example
```
POST https://api.us.cloud.talend.com/security/workspaces/7a35e78eaea645620e47f826/users/d13404b5-e9nc-4g5f-9904-a5f0dc287fb0/permissions
["AUTHOR", "EXECUTE"]
```
If you are adding a new permission to an already assigned user on the specified workspace, use the PUT /security/workspaces/{workspaceId}/users/{userId}/permissions endpoint and add the permission(s) in the body of the request.
Example
```
PUT https://api.us.cloud.talend.com/security/workspaces/7a35e78eaea645620e47f826/users/d13404b5-e9nc-4g5f-9904-a5f0dc287fb0/permissions
["AUTHOR", "EXECUTE"]
```