# Embed Tokens

Embed tokens enable safely sharing your private maps.

With these APIs, you can generate secure tokens for embedding maps.

## Create an Embed Token

> Creates a short-lived (15 minutes) token for authenticating a visitor to view a private embedded map view without being logged into Felt. You must provide a \`user\_email\` to associate the token with the end user that will be viewing the map.\
> Each end user should be a member of your Felt workspace with a viewer, editor, or admin role assigned.\
> \### Usage\
> \* Generate a token by making a call to this API from your server\
> \* Securely pass the token to your frontend client\
> \* Include the token as a query parameter on the Embed URL in an iframe\
> \
> \`\`\`html\
> \<iframe src="[https://felt.com/embed/map/{mapId}?token={token}">\\](https://felt.com/embed/map/{mapId}?token={token}">\\)</iframe>\
> \`\`\`\
> \
> \#### Enabling Layer Export\
> \
> You can allow EmbedToken based page views to export layer data.\
> \
> \* Turn on "Viewer permissions: Export data" in Map settings<br>

````json
{"openapi":"3.0.0","info":{"title":"Felt","version":"2.0"},"tags":[{"description":"Embed tokens enable safely sharing your private maps.\n\nWith these APIs, you can generate secure tokens for embedding maps.\n","name":"Embed Tokens"}],"servers":[{"url":"https://felt.com","variables":{}}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"bearerFormat":"YOUR_API_KEY","scheme":"bearer","type":"http"}},"schemas":{"EmbedToken":{"properties":{"expires_at":{"format":"date_time","type":"string"},"token":{"type":"string"}},"title":"EmbedToken","type":"object"},"UnauthorizedError":{"properties":{"errors":{"items":{"properties":{"detail":{"type":"string"},"source":{"properties":{"header":{"enum":["authorization"],"type":"string"}},"type":"object"},"title":{"type":"string"}},"type":"object"},"type":"array"}},"title":"UnauthorizedError","type":"object"},"NotFoundError":{"properties":{"errors":{"items":{"properties":{"detail":{"type":"string"},"source":{"properties":{"parameter":{"type":"string"}},"type":"object"},"title":{"type":"string"}},"type":"object"},"type":"array"}},"title":"NotFoundError","type":"object"},"JsonErrorResponse":{"properties":{"errors":{"items":{"properties":{"detail":{"type":"string"},"source":{"properties":{"pointer":{"type":"string"}},"required":["pointer"],"type":"object"},"title":{"type":"string"}},"required":["title","source","detail"],"type":"object"},"type":"array"}},"required":["errors"],"title":"JsonErrorResponse","type":"object"},"InternalServerError":{"properties":{"errors":{"items":{"properties":{"detail":{"type":"string"},"source":{"properties":{"parameter":{"type":"string"}},"type":"object"},"title":{"type":"string"}},"type":"object"},"type":"array"}},"title":"InternalServerError","type":"object"}}},"paths":{"/api/v2/maps/{map_id}/embed_token":{"post":{"callbacks":{},"description":"Creates a short-lived (15 minutes) token for authenticating a visitor to view a private embedded map view without being logged into Felt. You must provide a `user_email` to associate the token with the end user that will be viewing the map.\nEach end user should be a member of your Felt workspace with a viewer, editor, or admin role assigned.\n### Usage\n* Generate a token by making a call to this API from your server\n* Securely pass the token to your frontend client\n* Include the token as a query parameter on the Embed URL in an iframe\n\n```html\n<iframe src=\"https://felt.com/embed/map/{mapId}?token={token}\"></iframe>\n```\n\n#### Enabling Layer Export\n\nYou can allow EmbedToken based page views to export layer data.\n\n* Turn on \"Viewer permissions: Export data\" in Map settings\n","operationId":"create_map_embed_token","parameters":[{"description":"","in":"path","name":"map_id","required":true,"schema":{"type":"string"}},{"description":"Each token must be associated with the email address of the user who will use it.","in":"query","name":"user_email","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbedToken"}}},"description":"EmbedToken"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":"UnauthorizedError"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":"UnauthorizedError"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":"NotFoundError"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonErrorResponse"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonErrorResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}},"description":"InternalServerError"}},"summary":"Create an Embed Token","tags":["Embed Tokens"]}}}}
````


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.felt.com/rest-api/api-reference/embed-tokens.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.