Create Embed Token Endpoint
POST
/maps/{map_id}/embed-tokens/
const url = 'https://example.com/api/maps/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/embed-tokens/';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"expires_in_days":30,"name":"Public dashboard embed","allowed_origins":["https://dashboard.example.com"]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/maps/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/embed-tokens/ \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "expires_in_days": 30, "name": "Public dashboard embed", "allowed_origins": [ "https://dashboard.example.com" ] }'Create an embed token scoped to a map’s current layers.
Community supports the default 30-day unrestricted token. Custom lifetimes and non-empty origin restrictions require GeoLens Enterprise.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” map_id
required
Map Id
string format: uuid
Request Body required
Section titled “Request Body required ” Media type application/json
EmbedTokenCreate
object
expires_in_days
Expires In Days
Token lifetime in days (1-365). The default 30-day lifetime is available in Community; custom lifetimes require GeoLens Enterprise.
integer
Example
90 allowed_origins
Any of:
Array<string>
null
Responses
Section titled “ Responses ”Successful Response
Media type application/json
EmbedTokenCreatedResponse
object
id
required
Id
string format: uuid
map_id
required
Map Id
string format: uuid
token_hint
required
Token Hint
string
scoped_dataset_ids
required
Scoped Dataset Ids
Array<string>
allowed_origins
Any of:
Array<string>
null
expires_at
required
Expires At
string format: date-time
is_active
required
Is Active
boolean
use_count
Use Count
integer
created_at
required
Created At
string format: date-time
raw_token
required
Raw Token
string
Example
{ "use_count": 0}Bad request — invalid payload
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Unauthorized — missing or invalid credentials
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Forbidden — caller lacks write access
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Not found
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Conflict — resource state prevents the operation
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Validation error
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Internal server error
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}