Skip to Content

Additional Resources

Guest token request examples

Copy a working guest token request for each tenancy level.

Each example is a body for POST https://api.usedatabrain.com/api/v2/guest-token/create, sent from your backend with Authorization: Bearer <data app API token>. For what each field means, see Create a guest token.

Data app Overview with Go-live readiness on the left and Installation on the right, step 1 Backend mints a guest token highlighted above POST /api/v2/guest-token/create.
A data app's Overview shows the same request under Installation.

Table tenancy

clientId is a value of the client column, for example client_id.

{
  "clientId": "acme-corp",
  "dataAppName": "Customer Portal",
  "params": { "userIdentifier": "user_8812" }
}

Database tenancy

clientId is the customer’s schema name.

{
  "clientId": "acme_corp",
  "dataAppName": "Customer Portal",
  "params": { "userIdentifier": "user_8812" }
}

Multi-database tenancy

clientId is the customer’s database name.

{
  "clientId": "acme_corp_db",
  "dataAppName": "Customer Portal",
  "params": { "userIdentifier": "user_8812" }
}

Two datamarts in one workspace

Name the datamart to use.

{
  "clientId": "acme-corp",
  "dataAppName": "Customer Portal",
  "datamartName": "Sales datamart"
}

One hour, one dashboard, a time zone and a filter value

{
  "clientId": "acme-corp",
  "dataAppName": "Customer Portal",
  "expiryTime": 3600000,
  "params": {
    "userIdentifier": "user_8812",
    "allowedEmbeds": ["revenue-overview"],
    "timezone": "America/New_York",
    "dashboardAppFilters": [
      { "dashboardId": "revenue-overview", "values": { "Region": ["EMEA"] } }
    ]
  }
}

The filter name, here Region, must be an app filter on that dashboard. Dashboard app filter

Response

{ "token": "<guest token>", "expireAt": "2026-11-20T10:09:36.174Z" }

On this page