Skip to Content

Data App CRUD

Delete a data app

Remove a data app with its embeds, API tokens and scheduled reports.

DELETE
/api/v2/data-app
curl --request DELETE "https://api.usedatabrain.com/api/v2/data-app?name=Customer%20portal" \  --header "Authorization: Bearer $DATABRAIN_SERVICE_TOKEN"

You cannot undo this. The data app's embeds, API tokens, settings and the scheduled reports of its embeds are deleted too. Its API tokens stop working at once, so your app can no longer create guest tokens with them. Dashboards and workspaces stay.

Auth

A service token. See Authentication.

Authorization

ServiceToken
headerAuthorizationBearer <token>

A service token. A data app API token is refused.

Query

namestringrequired

The data app name.

Response

{ "name": "Customer portal" }

Errors

Statuserror.codeWhy
400INVALID_REQUEST_BODYname is missing
400DATA_APP_NOT_FOUNDNo data app has this name
403AUTHENTICATION_ERRORYou used a data app API token
500INTERNAL_SERVER_ERRORThe delete failed

For errors that every endpoint returns, see Authentication.

Example Request
curl -X DELETE 'https://api.usedatabrain.com/api/v2/data-app?name=string'
Example Response
{  "name": "Customer portal"}