# The IP allowlist API endpoints

The host to be used to access this API is: https://api.&lt;env&gt;.cloud.talend.com.

For the complete API documentation of this API, see https://api.&lt;env&gt;.cloud.talend.com/v1/management/swagger-ui/?urls.primaryName=IP%20Allowlist%20Management.

The &lt;env&gt; part is the name of your Cloud region. If you do not know what your region name is, see [Accessing Talend Cloud applications](https://help.qlik.com/talend/en-US/installation-guide-windows/Cloud/talend-cloud-application-url).

You must use your access token to call the API. For further information about how to generate an access token and how to use this token, see [Generating a Personal Access Token](https://help.qlik.com/talend/r/en-US/Cloud/management-console-user-guide/cloud-access-token).

The following table presents the IP allowlist API endpoints and their required permissions

| Operations | Methods | Resources | Required permissions |
| --- | --- | --- | --- |
| Retrieving the configuration of your IP allowlist policy, such as<br>the IPs on the list, whether this policy has been enabled | GET | /v1/management/ip-allowlist | Users - Management |
| Setting up the entire configuration of your IP allowlist policy.<br>With this request, you create an IP allowlist with or without adding IPs and<br>define whether to activate your IP allowlist policy at the same time.<br><br>Note that once your IP allowlist policy is<br>activated, only the IPs on your allowlist is allowed to access Talend Cloud. | POST | /v1/management/ip-allowlist | Users - Management |
| Updating the configuration of your IP allowlist policy. With this<br>request, you add IPs to the existing IP allowlist and activate or deactivate<br>your IP allowlist policy at the same time.<br><br>Note that once your IP<br>allowlist policy is activated, only the IPs on your allowlist is<br>allowed to access Talend Cloud. | PUT | /v1/management/ip-allowlist | Users - Management |
| Deleting your IP allowlist policy. | DELETE | /v1/management/ip-allowlist | Users - Management |
| Activating or deactivating your IP allowlist policy. | PATCH | /v1/management/ip-allowlist | Users - Management |
| Retrieving all the IPs from your IP allowlist. | GET | /v1/management/ip-allowlist/ips | Users - Management |
| Adding new IPs to the IP allowlist. | POST | /v1/management/ip-allowlist/ips | Users - Management |
| Updating a set of IPs on your IP allowlist. You need to provide the IDs<br>of the IPs to be updated in your request. | PUT | /v1/management/ip-allowlist/ips | Users - Management |
| Retrieving a specific IP by its ID on the IP allowlist. | GET | /v1/management/ip-allowlist/ips/&lt;ip\_entry\_id&gt; | Users - Management |
| Finding an IP on your IP allowlist by its ID and updating this IP with<br>the new address your provide in your request | PUT | /v1/management/ip-allowlist/ips/&lt;ip\_entry\_id&gt; | Users - Management |
| Deleting a specific ID from your IP allowlist. | DELETE | /v1/management/ip-allowlist/ips/&lt;ip\_entry\_id&gt; | Users - Management |