Skip to main content
POST
/
v1
/
embed
/
generate-session
Generate an embed session
curl --request POST \
  --url https://{tenant}.cubecloud.dev/api/v1/embed/generate-session \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "deploymentId": 123,
  "creatorMode": true,
  "email": "<string>",
  "embedTenantName": "<string>",
  "embedTheme": {
    "analyticsChat": {
      "backgroundColor": "<string>",
      "chatInput": {
        "backgroundColor": "<string>",
        "borderColor": "<string>"
      }
    },
    "chat": {
      "inputColor": "<string>"
    },
    "font": "<string>",
    "primaryColor": "<string>"
  },
  "ephemeralTtlSeconds": 123,
  "externalId": "<string>",
  "groupDefinitions": [
    {
      "name": "<string>",
      "description": "<string>"
    }
  ],
  "groups": [
    "<string>"
  ],
  "internalId": "<string>",
  "isEphemeral": true,
  "publicDashboardId": "<string>",
  "roles": [
    "<string>"
  ],
  "securityContext": {},
  "userAttributeDefinitions": [
    {
      "name": "<string>",
      "defaultValue": "<string>",
      "description": "<string>",
      "displayName": "<string>"
    }
  ],
  "userAttributes": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "userProfile": {
    "displayName": "<string>",
    "picture": "<string>"
  }
}
'
{
  "sessionId": "<string>"
}

Authorizations

Authorization
string
header
required

API key authentication. Send Authorization: Api-Key <YOUR_API_KEY>.

Body

application/json

GenerateSessionDTO

deploymentId
number
required
creatorMode
boolean | null
email
string | null
embedTenantName
string | null
Pattern: ^[a-z][a-z0-9-]{3,34}[a-z0-9]$
embedTheme
object
ephemeralTtlSeconds
number | null
externalId
string | null
groupDefinitions
object[] | null
groups
string[] | null
internalId
string | null
isEphemeral
boolean | null
publicDashboardId
string | null
roles
string[] | null
securityContext
object
userAttributeDefinitions
object[] | null
userAttributes
object[] | null
userProfile
object

Response

200 - application/json
sessionId
string
required