--- schema_version: "1" id: 45fa00f5325230999dabcd12a2ffa8687f3cf20916089e39c86dc29bf8eb8d5f title: Lens Input collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/bi_dev_guide_rest/bi_requests_lens_input.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_requests_lens_input.htm source_site: developer.salesforce.com content_type: documentation content_hash: 4af966f1f77f3d14825eb1a9a3634dfbac2d87fe23ec92e762e62a40286430f0 description: An Analytics lens. --- # Lens Input An Analytics lens. ## Properties Lens Input inherits properties from the abstract [Base Asset Input](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_requests_base_asset_reference_input.htm "The base Analytics asset."). These base properties appear in Lens Input alongside the properties defined explicitly in the following table.
Property Name Type Description Required or Optional Available Version
datasets Asset​Reference​Input[] The list of datasets used to create this lens. Required for POST, optional for PATCH 43.0
folder Asset​Reference​Input The folder in which this lens is stored. Required for POST, optional for PATCH 36.0
history​label String The history label of the lens version being saved. Optional 46.0
state Lens​State​Input The state of the lens. Required for POST, optional for PATCH 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)
Optional 51.0
visualization​Type Connect​Wave​Visualization​Type​Enum The visualization type of the lens. 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
 Required for POST, optional for PATCH 36.0
xmd Xmd​Input The asset XMD of the lens. Optional 43.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.")