# 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>


---

# 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://docs.ellipsis-drive.com/developers/common-integrations/share-ellipsis-drive-viewer-via-secure-links.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.