---
schema_version: "1"
id: 534595177be42e7efd5c4e78f6c12adec1534f96a252d2b283181ff8b503f18d
title: Lens Resources
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/bi_dev_guide_rest/bi_resources_lenses_overview.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_lenses_overview.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: bdc999262a415d1c7151a5309de0c0707d88ce022c0353e7a7b522d64ac303b2
description: Analytics lenses are how users view data in a dataset and are the basis for building any dashboard. These resources allow users to manage collections of lenses, individual lenses, and lens files.
---
# Lens Resources

Analytics lenses are how users view data in a dataset and are the basis for building any dashboard. These resources allow users to manage collections of lenses, individual lenses, and lens files.

Available resources:

| Resource | Description | Supported HTTP Method | Resource URL |
| --- | --- | --- | --- |
| [Lenses List Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_lenses.htm "Returns a list of Analytics lenses or creates a lens.") | Returns a collection of Analytics lenses, or creates a lens. | GET POST | /wave/lenses |
| [Lens Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_lenses_id.htm "Returns, deletes, or updates the lens with the specified ID or API name.") | Returns a JSON file that describes the structure of an Analytics lens with the specified ID, deletes a lens, or updates a lens. | GET DELETE PATCH | /wave/lenses/<lensIdOrApiName> |
| [Lens Bundle Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_lenses_id_bundle.htm "Returns or updates the lens bundle with the specified ID or API name.") | Returns a JSON file that describes the structure of an Analytics lens bundle with the specified ID or updates a lens bundle. | GET PUT | /wave/lenses/<lensIdOrApiName>​/bundle |
| [Lens File Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_lenses_id_files_id.htm "Returns or updates a file that is part of an Analytics lens.") | Returns a file that is part of an Analytics lens. | GET PUT | /wave/lenses/<lensIdOrApiName>​/files/<files ID> |

- **[Lenses List Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_lenses.htm)**  
    Returns a list of Analytics lenses or creates a lens.
- **[Lens Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_lenses_id.htm)**  
    Returns, deletes, or updates the lens with the specified ID or API name.
- **[Lens File Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_lenses_id_files_id.htm)**  
    Returns or updates a file that is part of an Analytics lens.
- **[Lens File Metadata Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_lenses_id_files.htm)**  
    Returns or creates the lens file metadata with the specified ID or API name.
- **[Lens Bundle Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_lenses_id_bundle.htm)**  
    Returns or updates the lens bundle with the specified ID or API name.