> For the complete documentation index, see [llms.txt](https://docs.ellipsis-drive.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ellipsis-drive.com/developers/common-integrations/share-ellipsis-drive-viewer-via-secure-links.md).

# Share Ellipsis Drive viewer via secure links

A viewer link combines a data reference (**Layer** or **Bookmark**) with an optional access control layer (**Token**).\
\
Using this structure, you can generate direct viewer links that reference either a single layer or a complete map configuration.

***

#### Share a single layer

To share a specific layer, construct a viewer URL using the layer ID:

```
https://app.ellipsis-drive.com/view?pathId={ID of your layer}
```

#### Share a multi-layer view

To share a map containing multiple layers:

1. Create a bookmark that includes the desired layers using [this API call](/developers/api-v3/path-bookmark/create-new-bookmark.md) or [this Python function](https://ellipsis-package.readthedocs.io/en/latest/path/bookmark/index.html#add).
2. Once you have created the bookmark, the API will return the bookmark ID
3. Use the bookmark ID in the viewer URL:

```
https://app.ellipsis-drive.com/view?pathId={ID of the bookmark}
```

Bookmarks represent a complete map state, including selected layers and configuration.

***

#### Enable access without login

If the data is not available via link sharing, users will be required to log in.

To provide direct access, you can generate a signed URL using an access token.\
Tokens are typically used when link sharing is disabled but controlled external access is still required.

After generating a token using [this API endpoint ](/developers/api-v3/account/access-tokens/create-access-token.md)or [this Python function](https://ellipsis-package.readthedocs.io/en/latest/account/accessToken/index.html#create), append it to the viewer URL:

```
https://app.ellipsis-drive.com/view?pathId={ID of the bookmark}&token={your created access token}}
```

Signed URLs allow controlled access without requiring user authentication.

***

#### Token behaviour and scope

Access tokens define how the shared link can be used. Depending on how the token is created, it can:

* Grant access to specific layers or bookmarks
* Be scoped to a limited set of actions or endpoints
* Expire after a defined period
* Be tied to a user, service, or system context

This allows you to share data securely while maintaining control over access and usage.

***

{% hint style="info" %}

### Key considerations

* Layer IDs reference individual datasets
* Bookmark IDs reference composed map views
* Tokens define access control on top of the data reference
  {% endhint %}

\ <br>