# 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.

[^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`.