Skip to main content
DELETE
Permanently delete a datasource from your organization. This will remove the datasource and all its associated configurations, including cached schemas.
This action is irreversible. Once a datasource is deleted, all its configurations and cached schemas will be permanently removed. Ensure no datamarts or other resources depend on this datasource before deletion.

Endpoint

Self-hosted Databrain Endpoint

Authentication

This endpoint requires a service token in the Authorization header. Service tokens differ from data app API keys and provide organization-level permissions. To access your service token:
  1. In Settings page, navigate to the Service Tokens section.
  2. Click the “Generate Token” button to create a new service token if you don’t have one already.

Headers

Authorization
string
required
Bearer token for API authentication. Use your service token.

Query Parameters

datasourceName
string
required
The name of the datasource to delete. Must match exactly as it was created.

Response

id
string
The ID of the deleted datasource for confirmation.
message
string
Success message confirming the deletion: “Datasource deleted successfully”.
error
null
Error field, null when successful. Not included in successful responses.

Examples

Error Codes

Next Steps

Create Datasource

Create a new datasource to replace the deleted one

List Datasources

View all remaining datasources in your organization

Update Datasource

Update datasource credentials instead of deleting

Create Datamart

Create datamarts using your remaining datasources