# 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-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>Edit a data source connection</td><td><a data-footnote-ref href="#user-content-fn-2"><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-2"><code>PUT /{technology}/bulk</code></a></li><li><a data-footnote-ref href="#user-content-fn-2"><code>POST /api/v2/data</code></a></li><li><a data-footnote-ref href="#user-content-fn-2"><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-2"><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-2"><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-2"><code>PUT /dataSource/bulk/{delete}</code></a></li><li><a data-footnote-ref href="#user-content-fn-2"><code>DELETE /api/v2/data/{connectionKey}</code></a></li><li><a data-footnote-ref href="#user-content-fn-2"><code>DELETE /{technology}/handler/{handlerId}</code></a></li><li><a data-footnote-ref href="#user-content-fn-2"><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></td></tr><tr><td>Enable a single data source</td><td><a data-footnote-ref href="#user-content-fn-3"><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-2"><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-3"><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: false</code></td></tr><tr><td>Bulk disable data sources</td><td><a data-footnote-ref href="#user-content-fn-2"><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-4"><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-2"><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-2"><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-5"><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-6"><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-7"><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 data source columns</td><td><ul><li><a data-footnote-ref href="#user-content-fn-2"><code>DELETE /dictionary/{dataSourceId}</code></a></li><li><a data-footnote-ref href="#user-content-fn-2"><code>POST /dictionary/{dataSourceId}</code></a></li><li><code>PUT</code> <a data-footnote-ref href="#user-content-fn-2"><code>/dictionary/{dataSourceId}</code></a></li></ul></td><td>No substitute. Data source columns 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-8"><code>PUT /dataSource/{dataSourceId}/access/{id}</code></a></li><li><a data-footnote-ref href="#user-content-fn-8"><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-8"><code>POST /subscription/deny</code></a></li><li><a data-footnote-ref href="#user-content-fn-8"><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>           |
| Search schema names      | [<mark style="color:blue;">`GET /schemas`</mark>](https://documentation.immuta.com/SaaS/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/SaaS/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 the upgraded technology will error with a `400`.

[^2]: Once the upgrade begins, any calls to this endpoint for data sources belonging to the upgraded connections will error with a `400`.

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

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

[^5]: Once the upgrade begins, any calls to this endpoint for upgraded technologies will error with a `400`.

[^6]: Once the upgrade begins, any calls to this endpoint to update the `connection` parameter for upgraded connections will error with a `400`.

[^7]: Once the upgrade begins, any calls to this endpoint for upgraded connections will error with a `400`.

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