--- schema_version: "1" id: e6cf8e6025d5dcb7b0856e51ad37adf737127978904c056255d3978f133f566e title: Lens collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/bi_dev_guide_rest/bi_responses_lens.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_lens.htm source_site: developer.salesforce.com content_type: documentation content_hash: 23a1a86bc4fa69a8908dcce0b2c124f3ae3e229a0c998d9fe32390f53290e95c description: Am Analytics lenses. --- # Lens Am Analytics lenses. ## Properties Lens inherits properties from the abstract [Base Templated Asset](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_base_templated_asset.htm "A base Analytics asset created from a template."). These base properties appear in Lens alongside the properties defined explicitly in the following table.
Property Name Type Description Filter Group and Version Available Version
allow​Preview Boolean Indicates whether the user is allowed to preview the lens. Small, 36.0 36.0
dataset Asset​Reference DEPRECATED A reference to the dataset used to create this lens. Small, 36.0 36.0-42.0
datasets Asset​Reference[] A list of the datasets that the lens uses. Small, 43.0 43.0
date​Version Integer The version of dates used by the lens. Valid values are:
  • 1
  • 2
 Small, 44.0 44.0
files Lens​File[] The list of the lens files. Medium, 36.0 36.0
files​Url String The URL to the lens files. Small, 36.0 36.0
folder Asset​Reference A reference to the folder in which this lens is stored. Small, 36.0 36.0
histories​Url String The URL for the lens histories associated with this lens. Small, 44.0 44.0
refresh​Date Date The date of the most recent current dataset that is used by the lens, in ISO8601 date format. Small, 36.0 36.0
state Lens​State The state of the lens. Big, 36.0 36.0
visibility Connect​Wave​Asset​Visibility​Type Indicates whether the asset is hidden from users with view access or not. Valid values are:
  • All (Show all assets)
  • Limited (Hide assets from viewers with view access)
Small, 51.0 51.0
visualization​Type String The visualization type used for this lens. Valid values are: Valid values are:
  • Bullet
  • Calendar​Heat​Map
  • Combo
  • Comparison​Table
  • Flatgauge
  • Gantt
  • Gauge
  • Heat​Map
  • Horizontal​Bar
  • Horizontal​Dot
  • Line
  • Matrix
  • Parallel​Coordinates
  • Pie
  • Pivot​Table
  • Polargauge
  • Pyramid
  • Rating
  • Scatter
  • Stack​Waterfall
  • Stacked​Horizontal​Bar
  • Stacked​Vertical​Bar
  • Time
  • Time​Bar
  • Time​Combo
  • Values​Table
  • Vertical​Bar
  • Vertical​Dot
  • Waterfall
 Small, 36.0 36.0
#### See Also - [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.")