Skip to Content

Data App CRUD

Create a data app

Make a data app to hold the embeds of one of your products.

POST
/api/v2/data-app
curl --request POST https://api.usedatabrain.com/api/v2/data-app \  --header "Authorization: Bearer $DATABRAIN_SERVICE_TOKEN" \  --header "Content-Type: application/json" \  --data '{ "name": "Customer portal" }'

Before you start

Authorization

ServiceToken
headerAuthorizationBearer <token>

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

Body

namestringrequired

The data app name. No other data app in your organization may have it.

Unknown fields are refused.

Response

{ "name": "Customer portal" }

The data app is an embedded data app. It has no API token and no embeds yet.

Errors

Statuserror.codeWhy
400INVALID_REQUEST_BODYname is missing or empty, or a field is unknown
400DATA_APP_ALREADY_EXISTSA data app has this name
403AUTHENTICATION_ERRORYou used a data app API token
403entitlement_requiredYour plan does not include embedding
500INTERNAL_SERVER_ERRORThe data app could not be saved

For errors that every endpoint returns, see Authentication.

Next, create an API token for it.

Example Request
curl -X POST 'https://api.usedatabrain.com/api/v2/data-app' \  -H 'Content-Type: application/json' \  -d '{  "name": "Customer portal"}'
Example Response
{  "name": "Customer portal"}