# API Changes

## Deprecated endpoints

The following endpoints have been deprecated with connections. Use the recommended endpoint instead.

<table><thead><tr><th width="187">Action</th><th width="192">Deprecated endpoint</th><th>Use this with connections instead</th></tr></thead><tbody><tr><td>Create a single data source</td><td><ul><li><a data-footnote-ref href="#user-content-fn-1"><code>POST /{technology}/handler</code></a></li><li><a data-footnote-ref href="#user-content-fn-1"><code>POST /api/v2/data</code></a></li></ul></td><td><p>Step 1: Ensure your system user has been granted access to the relevant object in the data platform.</p><p>Step 2: Wait until the next object sync or manually trigger a metadata crawl using <a href="../../../../../../../developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection#post-data-crawl-objectpath"><mark style="color:blue;"><code>POST /data/crawl/{objectPath*}</code></mark></a>.<br></p><p>Step 3: If the parent schema has <code>activateNewChildren: false</code>,</p><p><a href="../../../../../../../developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection#put-data-settings-objectpath"><mark style="color:blue;"><code>PUT /data/settings/{objectPath*}</code></mark></a> with <code>settings: isActive: true</code>.</p></td></tr><tr><td>Bulk create data sources</td><td><ul><li><a data-footnote-ref href="#user-content-fn-2"><code>POST /{technology}/handler</code></a></li><li><a data-footnote-ref href="#user-content-fn-1"><code>POST /api/v2/data</code></a></li></ul></td><td><p>Step 1: Ensure your system user has been granted access to the relevant object in the data platform.</p><p>Step 2: Wait until the next object sync or manually trigger a metadata crawl using <a href="../../../../../../../developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection#post-data-crawl-objectpath"><mark style="color:blue;"><code>POST /data/crawl/{objectPath*}</code></mark></a>.<br></p><p>Step 3: If the parent schema has <code>activateNewChildren: false</code>,</p><p><a href="../../../../../../../developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection#put-data-settings-objectpath"><mark style="color:blue;"><code>PUT /data/settings/{objectPath*}</code></mark></a> with <code>settings: isActive: true</code>.</p></td></tr><tr><td>Edit a data source connection</td><td><a data-footnote-ref href="#user-content-fn-3"><code>POST /api/v2/data</code></a></td><td>No substitute. Data sources no longer have their own separate connection details but are tied to the parent connection.</td></tr><tr><td>Bulk edit data source's connections</td><td><ul><li><a data-footnote-ref href="#user-content-fn-3"><code>PUT /{technology}/bulk</code></a></li><li><a data-footnote-ref href="#user-content-fn-3"><code>POST /api/v2/data</code></a></li><li><a data-footnote-ref href="#user-content-fn-3"><code>PUT /{technology}/handler/{handlerId}</code></a></li></ul></td><td>No substitute. Data sources no longer have their own separate connection details but are tied to the parent connection.</td></tr><tr><td>Run schema detection (object sync)</td><td><a data-footnote-ref href="#user-content-fn-3"><code>PUT /dataSource/detectRemoteChanges</code></a></td><td><a href="../../../../../../../developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection#post-data-crawl-objectpath"><mark style="color:blue;"><code>POST /data/crawl/{objectPath*}</code></mark></a></td></tr><tr><td>Delete a data source</td><td><a data-footnote-ref href="#user-content-fn-3"><code>DELETE /dataSource/{dataSourceId}</code></a></td><td><a href="../../../../../../../developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection#delete-data-object-objectpath"><mark style="color:blue;"><code>DELETE /data/object/{objectPath*}</code></mark></a></td></tr><tr><td>Bulk delete data sources</td><td><ul><li><a data-footnote-ref href="#user-content-fn-3"><code>PUT /dataSource/bulk/{delete}</code></a></li><li><a data-footnote-ref href="#user-content-fn-3"><code>DELETE /api/v2/data/{connectionKey}</code></a></li><li><a data-footnote-ref href="#user-content-fn-3"><code>DELETE /{technology}/handler/{handlerId}</code></a></li><li><a data-footnote-ref href="#user-content-fn-3"><code>DELETE /dataSource/{dataSourceId}</code></a></li></ul></td><td><a href="../../../../../../../developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection#delete-data-object-objectpath"><mark style="color:blue;"><code>DELETE /data/object/{objectPath</code></mark></a><mark style="color:blue;"><code>*}</code></mark></td></tr><tr><td>Enable a single data source</td><td><a data-footnote-ref href="#user-content-fn-4"><code>PUT /dataSource/{dataSourceId}</code></a></td><td><a href="../../../../../../../developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection#put-data-settings-objectpath"><mark style="color:blue;"><code>PUT /data/settings/{objectPath*}</code></mark></a> with <code>settings: isActive: true</code></td></tr><tr><td>Bulk enable data sources</td><td><a data-footnote-ref href="#user-content-fn-3"><code>PUT /dataSource/bulk/{restore}</code></a></td><td><a href="../../../../../../../developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection#put-data-settings-objectpath"><mark style="color:blue;"><code>PUT /data/settings/{objectPath*}</code></mark></a> with <code>settings: isActive: true</code></td></tr><tr><td>Disable a single data source</td><td><a data-footnote-ref href="#user-content-fn-4"><code>PUT /dataSource/{dataSourceId}</code></a></td><td><a href="../../../../../../../developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection#put-data-settings-objectpath"><mark style="color:blue;"><code>PUT /data/settings/{objectPath</code></mark></a><mark style="color:blue;"><code>*}</code></mark> with <code>settings: isActive: false</code></td></tr><tr><td>Bulk disable data sources</td><td><a data-footnote-ref href="#user-content-fn-3"><code>PUT /dataSource/bulk/{disable}</code></a></td><td><a href="../../../../../../../developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection#put-data-settings-objectpath"><mark style="color:blue;"><code>PUT /data/settings/{objectPath*}</code></mark></a> with <code>settings: isActive: false</code></td></tr><tr><td>Edit a data source name</td><td><a data-footnote-ref href="#user-content-fn-5"><code>PUT /dataSource/{dataSourceId}</code></a></td><td>No substitute. Data source names are automatically generated based on information from your data platform.</td></tr><tr><td>Edit a display name</td><td><a data-footnote-ref href="#user-content-fn-3"><code>POST /api/v2/data/{connectionKey}</code></a></td><td>No substitute. Data sources no longer have their own separate connection details but are tied to the parent connection.</td></tr><tr><td>Override a host name</td><td><a data-footnote-ref href="#user-content-fn-3"><code>PUT /dataSource/{dataSourceId}/overrideHost</code></a></td><td>No substitute. Data sources no longer have their own separate connection details but are tied to the parent connection.</td></tr><tr><td>Create an integration/connection</td><td><a data-footnote-ref href="#user-content-fn-6"><code>POST /integrations</code></a></td><td><a href="../../../../../../developer-guides/api-intro/connections-api/how-to-guides/register-a-connection"><mark style="color:blue;"><code>POST /data/connection</code></mark></a></td></tr><tr><td>Update an integration/connection</td><td><a data-footnote-ref href="#user-content-fn-7"><code>PUT /integrations/{integrationId}</code></a></td><td><a href="../../../../../../../developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection#put-data-connection-connectionkey"><mark style="color:blue;"><code>PUT /data/connection/{connectionKey}</code></mark></a></td></tr><tr><td>Delete an integration/connection</td><td><a data-footnote-ref href="#user-content-fn-8"><code>DELETE /integrations/{integrationId}</code></a></td><td><a href="../../../../../../developer-guides/api-intro/connections-api/how-to-guides/deregister-a-connection"><mark style="color:blue;"><code>DELETE /data/object/{connectionKey}</code></mark></a></td></tr><tr><td>Delete and update a data dictionary</td><td><ul><li><a data-footnote-ref href="#user-content-fn-3"><code>DELETE /dictionary/{dataSourceId}</code></a></li><li><a data-footnote-ref href="#user-content-fn-3"><code>POST /dictionary/{dataSourceId}</code></a></li><li><code>PUT</code> <a data-footnote-ref href="#user-content-fn-3"><code>/dictionary/{dataSourceId}</code></a></li></ul></td><td>No substitute. Data source dictionaries are automatically generated based on information from your data platform.</td></tr><tr><td>Update a data source owner</td><td><ul><li><a data-footnote-ref href="#user-content-fn-9"><code>PUT /dataSource/{dataSourceId}/access/{id}</code></a></li><li><a data-footnote-ref href="#user-content-fn-9"><code>DELETE /dataSource/{dataSourceId}/unsubscribe</code></a></li></ul></td><td><a href="../../../../../../../developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection#put-data-settings-objectpath"><mark style="color:blue;"><code>PUT /data/settings/{objectPath*}</code></mark></a> with <code>settings: dataOwners</code></td></tr><tr><td>Response to a data source owner request</td><td><ul><li><a data-footnote-ref href="#user-content-fn-9"><code>POST /subscription/deny</code></a></li><li><a data-footnote-ref href="#user-content-fn-9"><code>POST /subscription/deny/bulk</code></a></li></ul></td><td><a href="../../../../../../../developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection#put-data-settings-objectpath"><mark style="color:blue;"><code>PUT /data/settings/{objectPath*}</code></mark></a> with <code>settings: dataOwners</code></td></tr></tbody></table>

## Impacted endpoints

If you have any automated actions using the following APIs, ensure you do the required change after the upgrade to ensure they continue working as expected.

| Action                                          | Impacted endpoint                                                                                                                                                                                                                                                                                                                                                                                             | Required change                                                                                                                                                                                                                                                                                            |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search for a data source                        | <ul><li><a href="../../../../../../../developer-guides/api-intro/immuta-v1-api/data-sources#get-data-source-by-name"><mark style="color:blue;"><code>GET /dataSource/name/{dataSourceName}</code></mark></a></li><li><a href="../../../../../../../developer-guides/api-intro/immuta-v1-api/data-sources#search-for-data-sources"><mark style="color:blue;"><code>GET /dataSource</code></mark></a></li></ul> | <ul><li>Data source names will change with the upgrade. Update <code>{dataSourceName}</code> in the request with the new data source name.</li><li>Data sources names will change with the upgrade. Update the <code>searchText</code> in the payload with the new data source name.</li></ul>             |
| Apply identification frameworks to data sources | [<mark style="color:blue;">`PUT /sdd/template/apply`</mark>](https://documentation.immuta.com/2025.1/developer-guides/api-intro/immuta-v1-api/configure-your-instance-of-immuta/manage-identification/sdd-api#apply-identification-frameworks-to-data-sources)                                                                                                                                                | Data source names will change with the upgrade. Update the `sources` in the payload with the new data source names.                                                                                                                                                                                        |
| Run SDD on data sources                         | [<mark style="color:blue;">`POST /sdd/run`</mark>](https://documentation.immuta.com/2025.1/developer-guides/api-intro/immuta-v1-api/configure-your-instance-of-immuta/manage-identification/sdd-api#run-sdd-on-data-sources)                                                                                                                                                                                  | Data source names will change with the upgrade. Update the `sources` in the payload with the new data source names.                                                                                                                                                                                        |
| Search schema names                             | [<mark style="color:blue;">`GET /schemas`</mark>](https://documentation.immuta.com/2025.1/developer-guides/api-intro/immuta-v1-api/manage-data-access/schemas)                                                                                                                                                                                                                                                | This endpoint will not search the schemas of connection data sources. Instead use the [<mark style="color:blue;">`GET /data/object/{objectPath}`</mark>](https://documentation.immuta.com/2025.1/developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection#get-data-object-objectpath). |

[^1]: Once the upgrade begins, any calls to this endpoint for Snowflake or Databricks Unity Catalog with error will a `400`.

[^2]: Once the upgrade begins, any calls to this endpoint for Snowflake or Databricks Unity Catalog will error with a `400`.

[^3]: Once the upgrade begins, any calls to this endpoint for data sources belonging to the Snowflake or Databricks Unity Catalog upgraded connections will error with a `400`.

[^4]: Once the upgrade begins, any calls to this endpoint to modify the `deleted` parameter for data sources belonging to the Snowflake or Databricks Unity Catalog upgraded connections will error with a `400`.

[^5]: Once the upgrade begins, any calls to this endpoint to modify the `name` parameter for data sources belonging to the Snowflake or Databricks Unity Catalog upgraded connections will error with a `400`.

[^6]: Once the upgrade begins, any calls to this endpoint for Snowflake or Databricks Unity Catalog technologies will error with a `400`.

[^7]: Once the upgrade begins, any calls to this endpoint to update the `connection` parameter for Snowflake or Databricks Unity Catalog upgraded connections will error with a `400`.

[^8]: Once the upgrade begins, any calls to this endpoint for Snowflake or Databricks Unity Catalog upgraded connections will error with a `400`.

[^9]: Once the upgrade begins, any calls to this endpoint to update data source owners of data sources belonging to the Snowflake or Databricks Unity Catalog upgraded connections will error with a `400`.