Data App CRUD
List data apps
Get every embedded data app in your organization, with its embeds.
GET
curl "https://api.usedatabrain.com/api/v2/data-app?isPagination=true&pageNumber=1" \ --header "Authorization: Bearer $DATABRAIN_SERVICE_TOKEN"Auth
A service token. See Authentication.
ServiceTokenheader
AuthorizationBearer <token>A service token. A data app API token is refused.
Query
isPaginationstring
true returns 10 data apps per page. Without it you get all.
The order is not fixed and there is no total count.
Response
{ "data": [ { "name": "Customer portal", "type": "embedded", "createdAt": "2026-11-01T10:00:00.000Z", "updatedAt": "2026-11-15T12:30:00.000Z", "embedCount": 1, "embeds": [ { "name": "Sales overview", "embedId": "sales-overview", "createdAt": "2026-11-10T08:00:00.000Z", "updatedAt": "2026-11-10T08:00:00.000Z" } ] } ]}Only embedded data apps are listed. Slack and Microsoft Teams apps are not.
Errors
| Status | error.code | Why |
|---|---|---|
| 403 | AUTHENTICATION_ERROR | You used a data app API token |
| 500 | INTERNAL_SERVER_ERROR | The list could not be read |
For errors that every endpoint returns, see Authentication.
curl -X GET 'https://api.usedatabrain.com/api/v2/data-app'Example Response
{ "data": [ { "name": "Customer portal", "type": "embedded", "createdAt": "2026-11-01T10:00:00.000Z", "updatedAt": "2026-11-15T12:30:00.000Z", "embedCount": 1, "embeds": [ { "name": "Sales overview", "embedId": "sales-overview", "createdAt": "2026-11-10T08:00:00.000Z", "updatedAt": "2026-11-10T08:00:00.000Z" } ] } ]}