# 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="/pages/mKifsAJjpgcGhGrENAST#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="/pages/mKifsAJjpgcGhGrENAST#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="/pages/mKifsAJjpgcGhGrENAST#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="/pages/mKifsAJjpgcGhGrENAST#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="/pages/mKifsAJjpgcGhGrENAST#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="/pages/mKifsAJjpgcGhGrENAST#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="/pages/mKifsAJjpgcGhGrENAST#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="/pages/mKifsAJjpgcGhGrENAST#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="/pages/mKifsAJjpgcGhGrENAST#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="/pages/mKifsAJjpgcGhGrENAST#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="/pages/mKifsAJjpgcGhGrENAST#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="/pages/KMnHVsnztYOYHYAdhtRu"><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="/pages/mKifsAJjpgcGhGrENAST#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="/pages/W3zH64lnu4lzR3Wl7yuR"><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="/pages/mKifsAJjpgcGhGrENAST#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="/pages/mKifsAJjpgcGhGrENAST#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="/pages/a404JRNE4VCOLBCZj4FT#get-data-source-by-name"><mark style="color:blue;"><code>GET /dataSource/name/{dataSourceName}</code></mark></a></li><li><a href="/pages/a404JRNE4VCOLBCZj4FT#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>](/saas/developer-guides/api-intro/immuta-v1-api/manage-data-access/schemas.md)                                                                                                                                                                                 | This endpoint will not search the schemas of connection data sources. Instead use the [<mark style="color:blue;">`GET /data/object/{objectPath}`</mark>](/saas/developer-guides/api-intro/connections-api/how-to-guides/manage-a-connection.md#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`.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.immuta.com/saas/configuration/integrations/data-and-integrations/registering-a-connection/reference-guides/upgrading-to-connections/api-changes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.