---
schema_version: "1"
id: 517cb0d43613670d35a91c850e8168a6a1010cd43f34db58f03861a90fc69d4d
title: Models Resource
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/bi_dev_guide_rest_sdd/bi_sdd_resources_models.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_sdd_resources_models.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 7e975ff15c4a79560638f60a29e249bf007ea884fced536c47a27c4c5ec1f6ba
description: Returns a collection of Einstein Discovery models and creates a model.
---
# Models Resource

Returns a collection of Einstein Discovery models and creates a model.

Resource URL

/smartdatadiscovery/models

Formats

JSON

Available Version

48.0

HTTP Methods

GET POST

Request parameters for GET

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





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

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

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

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

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

                </tr>

              </thead>

              <tbody class="tbody">
                <tr>
                  <td class="entry" headers="d44772e101" data-title="Parameter Name"><samp class="codeph nolang">order</samp></td>

                  <td class="entry" headers="d44772e104" data-title="Type">Smart​Data​Discovery​Sort​Order​Enum</td>

                  <td class="entry" headers="d44772e107" data-title="Description">The sort order for the collection. Valid values are: <ul class="ul bulletList">
                      <li class="li"><samp class="codeph nolang">Ascending</samp></li>

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

                    </ul>
                  </td>

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

                  <td class="entry" headers="d44772e113" data-title="Available Version">48.0</td>

                </tr>

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

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

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

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

                  <td class="entry" headers="d44772e113" data-title="Available Version">48.0</td>

                </tr>

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

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

                  <td class="entry" headers="d44772e107" 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="d44772e110" data-title="Required or Optional">Optional</td>

                  <td class="entry" headers="d44772e113" data-title="Available Version">48.0</td>

                </tr>

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

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

                  <td class="entry" headers="d44772e107" data-title="Description">Search terms. Individual terms are separated by spaces. A wildcard is
                    automatically appended to the last token in the query string. If the user’s
                    search query contains quotation marks or wildcards, those symbols are
                    automatically removed from the query string in the URI along with any other
                    special characters.</td>

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

                  <td class="entry" headers="d44772e113" data-title="Available Version">48.0</td>

                </tr>

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

                  <td class="entry" headers="d44772e104" data-title="Type">Smart​Data​Discovery​AI​Model​Collection​Sort​Order​Type​Enum</td>

                  <td class="entry" headers="d44772e107" data-title="Description">The sort order type for the collection. Valid values are: <ul class="ul bulletList">
                      <li class="li"><samp class="codeph nolang">Created​Date</samp></li>

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

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

                      <li class="li"><samp class="codeph nolang">Prediction​Field​Name</samp></li>

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

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

                    </ul>
                  </td>

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

                  <td class="entry" headers="d44772e113" data-title="Available Version">48.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d44772e101" data-title="Parameter Name"><samp class="codeph nolang">source​Type</samp></td>

                  <td class="entry" headers="d44772e104" data-title="Type">Smart​Data​Discovery​Model​Source​Type​Enum</td>

                  <td class="entry" headers="d44772e107" data-title="Description">Filters the collection by source type. Valid values are: <ul class="ul bulletList">
                      <li class="li"><samp class="codeph nolang">Discovery</samp></li>

                      <li class="li"><samp class="codeph nolang">User​Upload</samp></li>

                    </ul>
                  </td>

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

                  <td class="entry" headers="d44772e113" data-title="Available Version">48.0</td>

                </tr>

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

                  <td class="entry" headers="d44772e104" data-title="Type">Smart​Data​Discovery​AI​Model​Status​Enum</td>

                  <td class="entry" headers="d44772e107" data-title="Description">Filters the collection by status. Valid values are: <ul class="ul bulletList">
                      <li class="li"><samp class="codeph nolang">Disabled</samp></li>

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

                      <li class="li"><samp class="codeph nolang">Upload​Completed</samp></li>

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

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

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

                      <li class="li"><samp class="codeph nolang">Validation​Completed</samp></li>

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

                    </ul>
                  </td>

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

                  <td class="entry" headers="d44772e113" data-title="Available Version">48.0</td>

                </tr>

                <tr>
                  <td class="entry" headers="d44772e101" data-title="Parameter Name"><samp class="codeph nolang">story​History​Id</samp></td>

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

                  <td class="entry" headers="d44772e107" data-title="Description">Filters the collection by story history ID (9B4).</td>

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

                  <td class="entry" headers="d44772e113" data-title="Available Version">48.0</td>

                </tr>

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

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

                  <td class="entry" headers="d44772e107" data-title="Description">Filters the collection by story ID (1Y3).</td>

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

                  <td class="entry" headers="d44772e113" data-title="Available Version">48.0</td>

                </tr>

              </tbody>

            </table>

Response body for GET

[Smart Data Discovery AI Model Collection](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_sdd_responses_smart_data_discovery_ai_model_collection.htm "A collection of Einstein Discovery AI models.")

Request body for POST

[Smart Data Discovery AI Model Input](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_sdd_requests_smart_data_discovery_ai_model_input.htm "The Einstein Discovery AI model to create or update.")

Response body for POST

[Smart Data Discovery AI Model](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest_sdd.meta/bi_dev_guide_rest_sdd/bi_sdd_responses_smart_data_discovery_ai_model.htm "An Einstein Discovery AI model to retrieve.")