Generate tokens for cookieless embed session

Version 4.0.24.20 (latest)

Generate api and navigation tokens for a cookieless embed session

The generate tokens endpoint is used to create new tokens of type:

  • Api token.
  • Navigation token. The generate tokens endpoint should be called every time the Looker client asks for a token (except for the first time when the tokens returned by the acquire_session endpoint should be used).

Embed session expiration handling

This endpoint does NOT return an error when the embed session expires. This is to simplify processing in the caller as errors can happen for non session expiration reasons. Instead the endpoint returns the session time to live in the session_reference_token_ttl response property. If this property contains a zero, the embed session has expired.

Calls to this endpoint require Embedding to be enabled

Request

PUT /embed/cookieless_session/generate_tokens
Datatype
Description
Request
HTTP Request
body
HTTP Body
Expand HTTP Body definition...
body
Embed session reference token
Expand EmbedCookielessSessionGenerateTokens definition...
session_reference_token
string
Token referencing the embed session and is used to generate new authentication, navigation and api tokens.
navigation_token
string
Token used to load and navigate between Looker pages.
api_token
string
Token to used to call Looker APIs.

Response

200: Generated api and navigations tokens for the cookieless embed session.

Datatype
Description
navigation_token
string
Token used to load and navigate between Looker pages.
navigation_token_ttl
integer
Navigation token time to live in seconds.
api_token
string
Token to used to call Looker APIs.
api_token_ttl
integer
Api token time to live in seconds.
session_reference_token
string
Token referencing the embed session and is used to generate new authentication, navigation and api tokens.
session_reference_token_ttl
integer
Session reference token time to live in seconds. Note that this is the same as actual session.

400: Bad Request

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link

404: Not Found

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link

422: Validation Error

Datatype
Description
(object)
message
string
Error details
Expand ValidationErrorDetail definition...
field
string
Field with error
code
string
Error code
message
string
Error info message
documentation_url
string
Documentation link
documentation_url
string
Documentation link

429: Too Many Requests

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link