Skip to Content

Data App CRUD

List data apps

Get every embedded data app in your organization, with its embeds.

GET
/api/v2/data-app
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.

Authorization

ServiceToken
headerAuthorizationBearer <token>

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

Query

true returns 10 data apps per page. Without it you get all.

pageNumberinteger

Page, from 1

Default: 1

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

Statuserror.codeWhy
403AUTHENTICATION_ERRORYou used a data app API token
500INTERNAL_SERVER_ERRORThe list could not be read

For errors that every endpoint returns, see Authentication.

Example Request
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"        }      ]    }  ]}