---
schema_version: "1"
id: e6ed8da8d576f9add4e0ecb4be4ea3ac54c3393bad165f335b9dfa205bbf5854
title: Auto-Install Requests List Resource
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/bi_dev_guide_rest/bi_resources_autoinstallrequests.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_autoinstallrequests.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: a6993d08c25147f8347e7a7cc47ada73c933da281b290d01a45f56e324e94536
description: Returns a collection of auto-install requests for Analytics embedded apps, creates an auto-install request, or deletes groups of auto-install requests by an Analytics folder ID or a template API name.
---
# Auto-Install Requests List Resource

Returns a collection of auto-install requests for Analytics embedded apps, creates an auto-install request, or deletes groups of auto-install requests by an Analytics folder ID or a template API name.

Resource URL

/wave/auto-install-requests

Formats

JSON

Available Version

50.0

HTTP Methods

GET POST DELETE

Request parameters for GET

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





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

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

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

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

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

                </tr>

              </thead>

              <tbody class="tbody">
                <tr>
                  <td class="entry" headers="d110586e100" data-title="Parameter Name"><samp class="codeph nolang">folder​Id</samp></td>

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

                  <td class="entry" headers="d110586e106" data-title="Description">Filters the results to include only the contents of a specific folder.
                    The id can be the requesting user’s ID for items in the user’s private
                    folder.</td>

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

                  <td class="entry" headers="d110586e112" data-title="Available Version">50.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d110586e100" data-title="Parameter Name"><samp class="codeph nolang">folder​Label</samp></td>

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

                  <td class="entry" headers="d110586e106" data-title="Description">Filters the results to include only the contents of a specific folder by label.</td>

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

                  <td class="entry" headers="d110586e112" data-title="Available Version">50.0</td>

                </tr>

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

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

                  <td class="entry" headers="d110586e106" data-title="Description">The number of items to be returned in a single page. Minimum is 1,
                    maximum is 200, and default is 25.</td>

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

                  <td class="entry" headers="d110586e112" data-title="Available Version">50.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d110586e100" data-title="Parameter Name"><samp class="codeph nolang">request​Name</samp></td>

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

                  <td class="entry" headers="d110586e106" data-title="Description">Filters the results to include only the contents with a specific auto-install
                    request name.</td>

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

                  <td class="entry" headers="d110586e112" data-title="Available Version">50.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d110586e100" data-title="Parameter Name"><samp class="codeph nolang">request​Statuses</samp></td>

                  <td class="entry" headers="d110586e103" data-title="Type">Auto​Install​Request​Status​Enum[]</td>

                  <td class="entry" headers="d110586e106" data-title="Description">Filters the results to include only the contents with a specific auto-install
                    request status. Valid values include: <ul class="ul bulletList">
                      <li class="li"><samp class="codeph nolang">App​In​Progress</samp></li>

                      <li class="li"><samp class="codeph nolang">Cancelled</samp></li>

                      <li class="li"><samp class="codeph nolang">Enqueued</samp></li>

                      <li class="li"><samp class="codeph nolang">Failed</samp></li>

                      <li class="li"><samp class="codeph nolang">In​Progress</samp></li>

                      <li class="li"><samp class="codeph nolang">New</samp></li>

                      <li class="li"><samp class="codeph nolang">Skipped</samp></li>

                      <li class="li"><samp class="codeph nolang">Success</samp></li>

                    </ul>
                  </td>

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

                  <td class="entry" headers="d110586e112" data-title="Available Version">50.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d110586e100" data-title="Parameter Name"><samp class="codeph nolang">request​Types</samp></td>

                  <td class="entry" headers="d110586e103" data-title="Type">Auto​Install​Request​Type​Enum[]</td>

                  <td class="entry" headers="d110586e106" data-title="Description">Filters the results to include only the contents with a specific auto-install
                    request type. Valid values include: <ul class="ul bulletList">
                      <li class="li"><samp class="codeph nolang">Org​Compatibility​Check</samp></li>

                      <li class="li"><samp class="codeph nolang">Start​Dataflow</samp></li>

                      <li class="li"><samp class="codeph nolang">Wave​App​Auto​Update</samp></li>

                      <li class="li"><samp class="codeph nolang">Wave​App​Create</samp></li>

                      <li class="li"><samp class="codeph nolang">Wave​App​Delete</samp></li>

                      <li class="li"><samp class="codeph nolang">Wave​App​Update</samp></li>

                      <li class="li"><samp class="codeph nolang">Wave​Enable</samp></li>

                    </ul>
                  </td>

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

                  <td class="entry" headers="d110586e112" data-title="Available Version">50.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d110586e100" data-title="Parameter Name"><samp class="codeph nolang">search​Options</samp></td>

                  <td class="entry" headers="d110586e103" data-title="Type">Auto​Install​Request​Search​Option​Enum[]</td>

                  <td class="entry" headers="d110586e106" data-title="Description">Filters the results to include only the contents with specific search options.
                    Valid values include: <ul class="ul bulletList">
                      <li class="li"><samp class="codeph nolang">Exclude​Non​Existing​Apps</samp></li>

                      <li class="li"><samp class="codeph nolang">Most​Recent​Only​By​Template​And​Folder</samp></li>

                      <li class="li"><samp class="codeph nolang">Non​Existing​Apps​Only</samp></li>

                    </ul>
                  </td>

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

                  <td class="entry" headers="d110586e112" data-title="Available Version">50.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d110586e100" data-title="Parameter Name"><samp class="codeph nolang">sort​Options</samp></td>

                  <td class="entry" headers="d110586e103" data-title="Type">Auto​Install​Request​Sort​Option​Enum[]</td>

                  <td class="entry" headers="d110586e106" data-title="Description">Sorts the results according to the given sort option.
                    Valid values include: <ul class="ul bulletList">
                      <li class="li"><samp class="codeph nolang">Created​Date​Ascending</samp></li>

                      <li class="li"><samp class="codeph nolang">Created​Date​Descending</samp></li>

                      <li class="li"><samp class="codeph nolang">Folder​Id​Ascending</samp></li>

                      <li class="li"><samp class="codeph nolang">Folder​Id​Descending</samp></li>

                      <li class="li"><samp class="codeph nolang">Folder​Label​Ascending</samp></li>

                      <li class="li"><samp class="codeph nolang">Folder​Label​Descending</samp></li>

                      <li class="li"><samp class="codeph nolang">Last​Modified​Date​Ascending</samp></li>

                      <li class="li"><samp class="codeph nolang">Last​Modified​DateD​escending</samp></li>

                      <li class="li"><samp class="codeph nolang">Request​Name​Ascending</samp></li>

                      <li class="li"><samp class="codeph nolang">Request​Name​Descending</samp></li>

                      <li class="li"><samp class="codeph nolang">Request​Status​Ascending</samp></li>

                      <li class="li"><samp class="codeph nolang">Request​Status​Descending</samp></li>

                      <li class="li"><samp class="codeph nolang">Request​Type​Ascending</samp></li>

                      <li class="li"><samp class="codeph nolang">Request​Type​Descending</samp></li>

                      <li class="li"><samp class="codeph nolang">Template​Api​Name​Ascending</samp></li>

                      <li class="li"><samp class="codeph nolang">Template​Api​Name​Descending</samp></li>

                    </ul>
                  </td>

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

                  <td class="entry" headers="d110586e112" data-title="Available Version">50.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d110586e100" data-title="Parameter Name"><samp class="codeph nolang">template​Api​Name</samp></td>

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

                  <td class="entry" headers="d110586e106" data-title="Description">Filters the results to include only the contents created
                    from a specific application template.</td>

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

                  <td class="entry" headers="d110586e112" data-title="Available Version">50.0</td>

                </tr>

              </tbody>

            </table>

The following REST URL shows how to use the request parameters to filter and sort in the GET request.

/wave/auto-install-requests?searchOptions=ExcludeNonExistingApps&sortOptions=RequestStatusAscending

Response body for GET

[Auto-Install Request Collection](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_auto_install_request_collection.htm "A collection of auto-install requests.")

Request body for POST

[Auto-Install Request Insert Input](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_requests_auto_install_request_insert_input.htm "The insert for an auto-install request.")

Response body for POST

[Auto-Install Request](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_auto_install_request.htm "A auto-install request.")