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 or this Python function.

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 or this Python function, 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.

---

Key considerations

• Layer IDs reference individual datasets

• Bookmark IDs reference composed map views

• Tokens define access control on top of the data reference