Stay organized with collections
Save and categorize content based on your preferences.
Version 4.0.25.14 (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.
NOTE: Calls to this endpoint require Embedding to be enabled. Usage of this endpoint is not authorized for Looker Core Standard and Looker Core Enterprise.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[],[],null,["# Generate tokens for cookieless embed session\n\nVersion 4.0.25.14 (latest)\n\n### Generate api and navigation tokens for a cookieless embed session\n\nThe generate tokens endpoint is used to create new tokens of type:\n\n- Api token.\n- 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).\n\n#### Embed session expiration handling\n\nThis endpoint does NOT return an error when the embed session expires. This is to simplify processing\nin the caller as errors can happen for non session expiration reasons. Instead the endpoint returns\nthe session time to live in the `session_reference_token_ttl` response property. If this property\ncontains a zero, the embed session has expired.\n\n**NOTE** : Calls to this endpoint require [Embedding](https://cloud.google.com/looker/docs/r/looker-core-feature-embed) to be enabled. Usage of this endpoint is not authorized for Looker Core Standard and Looker Core Enterprise.\n\nRequest\n-------\n\nPUT /embed/cookieless_session/generate_tokens \nDatatype \nDescription \nRequest \nHTTP Request \nbody \nHTTP Body \nExpand HTTP Body definition... \nbody \n[EmbedCookielessSessionGenerateTokens](/looker/docs/reference/looker-api/latest/types/EmbedCookielessSessionGenerateTokens) \nEmbed session reference token\nExpand EmbedCookielessSessionGenerateTokens definition... \nsession_reference_token \nstring \nToken referencing the embed session and is used to generate new authentication, navigation and api tokens. \nnavigation_token \nstring \nToken used to load and navigate between Looker pages. \napi_token \nstring \nToken to used to call Looker APIs.\n\nResponse\n--------\n\n### 200: Generated api and navigations tokens for the cookieless embed session.\n\nDatatype \nDescription \n(object) \n[EmbedCookielessSessionGenerateTokensResponse](/looker/docs/reference/looker-api/latest/types/EmbedCookielessSessionGenerateTokensResponse) \nnavigation_token \nstring \nToken used to load and navigate between Looker pages. \nnavigation_token_ttl \ninteger \nNavigation token time to live in seconds. \napi_token \nstring \nToken to used to call Looker APIs. \napi_token_ttl \ninteger \nApi token time to live in seconds. \nsession_reference_token \nstring \nToken referencing the embed session and is used to generate new authentication, navigation and api tokens. \nsession_reference_token_ttl \ninteger \nSession reference token time to live in seconds. Note that this is the same as actual session.\n\n### 400: Bad Request\n\nDatatype \nDescription \n(object) \n[Error](/looker/docs/reference/looker-api/latest/types/Error) \nmessage \n*lock* \nstring \nError details \ndocumentation_url \n*lock* \nstring \nDocumentation link\n\n### 403: Permission Denied\n\nDatatype \nDescription \n(object) \n[Error](/looker/docs/reference/looker-api/latest/types/Error) \nmessage \n*lock* \nstring \nError details \ndocumentation_url \n*lock* \nstring \nDocumentation link\n\n### 404: Not Found\n\nDatatype \nDescription \n(object) \n[Error](/looker/docs/reference/looker-api/latest/types/Error) \nmessage \n*lock* \nstring \nError details \ndocumentation_url \n*lock* \nstring \nDocumentation link\n\n### 422: Validation Error\n\nDatatype \nDescription \n(object) \n[ValidationError](/looker/docs/reference/looker-api/latest/types/ValidationError) \nmessage \n*lock* \nstring \nError details \nerrors \n[ValidationErrorDetail](/looker/docs/reference/looker-api/latest/types/ValidationErrorDetail)\\[\\] \nExpand ValidationErrorDetail definition... \nfield \n*lock* \nstring \nField with error \ncode \n*lock* \nstring \nError code \nmessage \n*lock* \nstring \nError info message \ndocumentation_url \n*lock* \nstring \nDocumentation link \ndocumentation_url \n*lock* \nstring \nDocumentation link\n\n### 429: Too Many Requests\n\nDatatype \nDescription \n(object) \n[Error](/looker/docs/reference/looker-api/latest/types/Error) \nmessage \n*lock* \nstring \nError details \ndocumentation_url \n*lock* \nstring \nDocumentation link"]]
