> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a Data Source

> Permanently remove a Data Source from Reporter when no active reports depend on its database connection.

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.

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

## Step by step

***

<Steps>
  <Step title="Open Data Sources">
    Go to **Data Sources**.
  </Step>

  <Step title="Find the connection">
    Locate the card for the Data Source you want to delete.
  </Step>

  <Step title="Open the delete action">
    Click the three vertical dots (<Icon icon="ellipsis-vertical" />) on the card and select **Delete**.
  </Step>

  <Step title="Confirm deletion">
    In the **Delete Connection** dialog, review the connection name and confirm the deletion.
  </Step>

  <Step title="Check the list">
    Confirm that the Data Source no longer appears on the **Data Sources** page.
  </Step>
</Steps>

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

***

<AccordionGroup>
  <Accordion title="Deleting a connection still used by Templates">
    Future Reports can fail if the Template expects data from a deleted connection. Confirm dependencies first.
  </Accordion>

  <Accordion title="Deleting instead of fixing credentials">
    If the connection is still operationally needed, edit credentials or SSL settings and run **Test Connection**.
  </Accordion>

  <Accordion title="Deleting without a replacement">
    If the reporting process continues, create and test the replacement Data Source before deleting the old one.
  </Accordion>
</AccordionGroup>

## Next steps

***

* Use [Add a Data Source](/en/lerian-console/reporter-console/adding-a-data-source) if a replacement connection is needed.
* Use [Test a Data Source Connection](/en/lerian-console/reporter-console/testing-a-data-source) to validate replacement connections.
* Use [Managing Data Sources](/en/lerian-console/reporter-console/managing-data-sources) to review the remaining active connections.

<Card title="API equivalent" type="tip" horizontal>
  [Delete connection endpoint](/en/reference/reporter/connections/delete-connection)
</Card>
