# Relevant endpoints

## Space permission endpoints

Managing space permissions requires the use of the following Management Console API endpoints:

| Path | Method | Description | Query parameters | Required |
| --- | --- | --- | --- | --- |
| /security/permissions | GET | Retrieve all space permissions according to search criteria | <ul> <li>userId</li> <li>workspaceID</li> <li>environmentID</li> </ul> | Optional |
| /security/permissions/batch | POST | Create sets of space permissions for a list of users | N/A | N/A |
| /security/permissions/batch | PUT | Update sets of space permissions for a list of users | N/A | N/A |
| /security/permissions/batch | DELETE | Delete sets of space permissions for a list of users | N/A | N/A |
| /security/workspaces/{workspaceId}/users/{userId}/permissions | GET | Retrieve the specified user's permissions in the specified<br>space | N/A | N/A |
| /security/workspaces/{workspaceId}/users/{userId}/permissions | POST | Assign permissions to the specified user in the specified<br>space | N/A | N/A |
| /security/workspaces/{workspaceId}/users/{userId}/permissions | PUT | Replace the specified user's permissions in the specified space with<br>the ones provided in the body of the request | N/A | N/A |
| /security/workspaces/{workspaceId}/users/{userId}/permissions | DELETE | Remove all permissions of the specified user in the specified<br>space | N/A | N/A |

## Related endpoints

Management Console API

URL: https://api.&lt;datacenter&gt;.cloud.talend.com/security. Replace &lt;datacenter&gt; with your Talend Cloud region. For more information, see [Accessing Talend Cloud applications](https://help.qlik.com/talend/en-US/installation-guide-windows/Cloud/talend-cloud-application-url).

| Endpoint | Use | Query parameters |
| --- | --- | --- |
| GET /orchestration/workspaces | Use this endpoint to retrieve the ID of the space for which you<br>want to set permissions. | query (FIQL format)<br><br>Example:<br>"name==TestWorkspace","environment.name==TestEnvironment" |

Example request:

```
GET https://api.us.cloud.talend.com/orchestration/workspaces?query=environment.name==default
```

User management API

URL: https://api.&lt;datacenter&gt;.cloud.talend.com/

| Endpoint | Use | Query parameters | Required |
| --- | --- | --- | --- |
| GET<br>/orchestration/users | Use this endpoint to retrieve the ID of the user you want to assign<br>permissions to on the space. | <ul> <li>page</li> <li>size</li> <li>workspace_id</li> </ul> | Optional |

Example request:

```
GET https://api.us.cloud.talend.com/orchestration/users?page=1&size=50&workdpace_id=534s4400223a343495467403a
```