Deregister a Host

To deregister a host from Immuta, do the following:

1. Generate a script to clean up any Immuta-managed resources from your data platform.

2. Delete the host in Immuta.

3. Run the script in Databricks Unity Catalog or Snowflake to clean up any Immuta-managed resources from your environment.

Step 1: Generate the cleanup script

POST /integrations/{id}/scripts/delete

Creates a script to remove Immuta-managed resources from your data platform.

Required Immuta permission: APPLICATION_ADMIN

curl -X 'POST' \
    'https://www.organization.immuta.com/integrations/1/scripts/delete' \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: 846e9e43c86a4ct1be14290d95127d13f'

Path parameters

Response

The response returns the script that you will run in your Databricks Unity Catalog or Snowflake environment. Copy it for later.

Step 2: Delete the host in Immuta

DELETE /data/object/{connectionKey}

Delete the given host and all its child objects.

Required Immuta permission: INFRASTRUCTURE_ADMIN or DATA_OWNER on the object

curl -X 'DELETE' \
    'https://<your-immuta-url>/data/object/yourConnectionKey' \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: <your-bearer-token>' \

Path parameters

Response schema

Example response

{
  objectPath: ['yourConnectionKey'],
  childCount: 5
}

Step 3: Run the cleanup script in your data platform

Using the copied generated cleanup script from earlier, run it in your Snowflake or Databricks Unity Catalog environment as a privileged user.

The script will remove any objects that were initially created during the Register a host process.