Data App CRUD
Delete a data app
Remove a data app with its embeds, API tokens and scheduled reports.
DELETE
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.
ServiceTokenheader
AuthorizationBearer <token>A service token. A data app API token is refused.
Query
The data app name.
Response
{ "name": "Customer portal" }Errors
| Status | error.code | Why |
|---|---|---|
| 400 | INVALID_REQUEST_BODY | name is missing |
| 400 | DATA_APP_NOT_FOUND | No data app has this name |
| 403 | AUTHENTICATION_ERROR | You used a data app API token |
| 500 | INTERNAL_SERVER_ERROR | The delete failed |
For errors that every endpoint returns, see Authentication.
curl -X DELETE 'https://api.usedatabrain.com/api/v2/data-app?name=string'Example Response
{ "name": "Customer portal"}