---
schema_version: "1"
id: 7ae0f70530a93ae86fe5177c80cdc4df3ada52b3678c21918cadaaf6c9b1fb1d
title: Lens File Metadata Resource
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/bi_dev_guide_rest/bi_resources_lenses_id_files.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_lenses_id_files.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 6b69bc753841aef39ffe587ea6d0d21ff8617a8e69eafaa36900750ebbfa0b22
description: Returns or creates the lens file metadata with the specified ID or API name.
---
# Lens File Metadata Resource

Returns or creates the lens file metadata with the specified ID or API name.

## Resource URL

/wave/lenses/<lensIdOrApiName>/files

## Formats

JSON

## Available Version

36.0

## HTTP Methods

GET POST

## GET Request Parameters

<table class="featureTable sort_table" summary="">





          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader vertical-align-top " id="d293046e93">Parameter Name</th>

              <th class="featureTableHeader vertical-align-top " id="d293046e96">Type</th>

              <th class="featureTableHeader vertical-align-top " id="d293046e99">Description</th>

              <th class="featureTableHeader vertical-align-top " id="d293046e102">Required or Optional</th>

              <th class="featureTableHeader vertical-align-top " id="d293046e105">Available Version</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d293046e93" data-title="Parameter Name"><samp class="codeph nolang">lens​Id​Or​Api​Name</samp></td>

              <td class="entry" headers="d293046e96" data-title="Type">ID</td>

              <td class="entry" headers="d293046e99" data-title="Description">The lens ID or API name to request the files for.</td>

              <td class="entry" headers="d293046e102" data-title="Required or Optional">Required</td>

              <td class="entry" headers="d293046e105" data-title="Available Version">36.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d293046e93" data-title="Parameter Name"><samp class="codeph nolang">page</samp></td>

              <td class="entry" headers="d293046e96" data-title="Type">String</td>

              <td class="entry" headers="d293046e99" data-title="Description">
                <p class="p">A generated token that indicates the view of the lenses to be returned.</p>

              </td>

              <td class="entry" headers="d293046e102" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d293046e105" data-title="Available Version">36.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d293046e93" data-title="Parameter Name"><samp class="codeph nolang">pageSize</samp></td>

              <td class="entry" headers="d293046e96" data-title="Type">Integer</td>

              <td class="entry" headers="d293046e99" data-title="Description">
                <p class="p">The number of items to be returned in a single page. Minimum is 1,</p>

                <p class="p"> maximum is 200, and default is 25.</p>

              </td>

              <td class="entry" headers="d293046e102" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d293046e105" data-title="Available Version">36.0</td>

            </tr>

          </tbody>

        </table>

## GET Response Body

[Wave File Metadata Collection](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_wave_file_metadata_collection.htm "A collection of the metadata for Analytics files.")

## POST Request Parameters

| Parameter Name | Type | Description | Required or Optional | Available Version |
| --- | --- | --- | --- | --- |
| lens​Id​Or​Api​Name | ID | The lens ID or API name to upload the file to. | Required | 36.0 |

## POST Request Body

The binary upload to create the preview file.

## POST Response Body

[Wave File Metadata](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_wave_file_metadata.htm "The metadata for an Analytics file.")