Delete a Data Source

Permanently remove a Data Source from Reporter when no active reports depend on its database connection, keeping your Console configuration clean.

Use this page to remove a Data Source that should no longer be available for future Templates or Reports.

Objective

---

Permanently delete a Data Source connection from Reporter.

For example, delete a Data Source when an external reporting database was retired, a temporary migration connection is no longer needed, or operators have moved to a replacement connection.

When to use

---

Use this task when:

• the database connection is retired;
• no current Template or reporting process should use it;
• a replacement Data Source exists, if the process continues;
• the connection was created by mistake and should not remain available.

Do not delete a Data Source just because it is not part of the current operator journey. Internal product Data Sources may be preconfigured for other Templates or future Reports.

Do not delete a Data Source just because a connection test failed. If the connection is still needed, edit and test it instead.

Before you start

---

Confirm:

• no active reporting process depends on the connection;
• current Templates do not rely on fields from this Data Source;
• operators know which replacement Data Source to use;
• the connection is not only failing temporarily because of credentials, network, schema, or SSL settings.

Deleting a Data Source is permanent. Future Report generation can fail if a Template or process still depends on this connection.

Step by step

---

1. Open Data Sources

   Go to Data Sources.

2. Find the connection

   Locate the card for the Data Source you want to delete.

3. Open the delete action

   Click the three vertical dots () on the card and select Delete.

4. Confirm deletion

   In the Delete Connection dialog, review the connection name and confirm the deletion.

5. Check the list

   Confirm that the Data Source no longer appears on the Data Sources page.

Field guide

---

Field or label	What to check	Example
Connection name	Confirms the Data Source that will be removed. The technical field is configName; check that it is the retired connection, not a replacement.	migration-postgres-temp
Connection ID	Technical UUID used by the API as the connectionId path parameter. The Console selects it when the operator chooses Delete.	018f2f4c-...
Delete	Action in the Data Source card menu. It starts the destructive flow and opens the confirmation dialog.	Select Delete on migration-postgres-temp.
Delete Connection	Final confirmation action. After this, the Data Source is permanently removed from the Data Sources list.	Confirm the temporary connection removal.

Expected result

---

The Data Source is removed from the list and can no longer be selected or used by future Reporter workflows.

Common errors and care points

---

Deleting a connection still used by Templates

Future Reports can fail if the Template expects data from a deleted connection. Confirm dependencies first.

Deleting instead of fixing credentials

If the connection is still operationally needed, edit credentials or SSL settings and run Test Connection.

Deleting without a replacement

If the reporting process continues, create and test the replacement Data Source before deleting the old one.

Next steps

---

• Use Add a Data Source if a replacement connection is needed.
• Use Test a Data Source Connection to validate replacement connections.
• Use Managing Data Sources to review the remaining active connections.

API equivalent

Delete connection endpoint