{
  "opencollection": "1.0.0",
  "info": {
    "name": "Downloads About Inventory API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "Authorization",
      "value": "{{Authorization}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Inventory",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Search assets",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://www.tenable.com/downloads/api/v2/api/v1/t1/inventory/assets/search",
            "params": [
              {
                "name": "extra_properties",
                "value": "",
                "type": "query",
                "description": "Specifies extra asset properties to include in the search results. You can provide multiple properties as a comma-separated list. \n\nUse the [List asset properties](ref:inventory-asset-properties-list) endpoint to retrieve a list of valid properties for this parameter. For example, you might include `created_at`, `sources`, and `fqdns` as extra properties."
              },
              {
                "name": "offset",
                "value": "",
                "type": "query",
                "description": "The starting record to retrieve. If omitted, the default value is `0`."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "The number of records to retrieve. If omitted, the default value is `1000`. The maximum value is `1000`."
              },
              {
                "name": "sort",
                "value": "acr:desc",
                "type": "query",
                "description": "The property and direction to sort the results by, in the format `property:direction`. For example: `asset_name:asc` or `acr:desc`"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Returns a list of assets in your organization that match the specified search criteria.\n\n**Caution:** This endpoint is available for use but is currently in beta. The response structure is subject to change as we continue to enhance the data model. <div class=\"perms-callout\">Requires the Basic [16] user role or the `ASSET_INVENTORY.CYBER_ASSET_MANAGEMENT.READ` and `AD.TOGGLE_AD.USE` custom role privileges. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Search findings",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://www.tenable.com/downloads/api/v2/api/v1/t1/inventory/findings/search",
            "params": [
              {
                "name": "extra_properties",
                "value": "",
                "type": "query",
                "description": "Specifies extra findings properties to include in the search results. You can provide multiple properties as a comma-separated list. \n\nUse the [List finding properties](ref:inventory-finding-properties-list) endpoint to retrieve a list of valid properties for this parameter. For example, you might include `asset_name`, `solution`, and `vpr_score` as extra properties."
              },
              {
                "name": "offset",
                "value": "",
                "type": "query",
                "description": "The starting record to retrieve. If omitted, the default value is `0`."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "The number of records to retrieve. If omitted, the default value is `1000`. The maximum value is `10000`."
              },
              {
                "name": "sort",
                "value": "severity:desc",
                "type": "query",
                "description": "The property and direction to sort the results by, in the format `property:direction`. For example: `finding_name:asc` or `severity:desc`"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Returns a list of findings in your organization that match the specified search criteria.\n\n**Caution:** This endpoint is available for use but is currently in beta. The response structure is subject to change as we continue to enhance the data model. <div class=\"perms-callout\">Requires the Basic [16] user role or the `ASSET_INVENTORY.CYBER_ASSET_MANAGEMENT.READ` and `AD.TOGGLE_AD.USE` custom role privileges. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Search software",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://www.tenable.com/downloads/api/v2/api/v1/t1/inventory/software/search",
            "params": [
              {
                "name": "extra_properties",
                "value": "",
                "type": "query",
                "description": "Specifies extra software properties include in the search results. You can provide multiple properties as a comma-separated list. \n\nUse the [List software properties](ref:inventory-software-properties-list) endpoint to retrieve a list of valid properties for this parameter. For example, you might include `cpe`, `version`, and `file_location` as extra properties."
              },
              {
                "name": "offset",
                "value": "",
                "type": "query",
                "description": "The starting record to retrieve. If omitted, the default value is `0`."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "The number of records to retrieve. If omitted, the default value is `1000`. The maximum value is `1000`."
              },
              {
                "name": "sort",
                "value": "application:asc",
                "type": "query",
                "description": "The property and direction to sort the results by, in the format `property:direction`. For example: `application:asc` or `version:desc`"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Returns a list of software installed on your assets that match the specified search criteria.\n\n**Caution:** This endpoint is available for use but is currently in beta. The response structure is subject to change as we continue to enhance the data model. <div class=\"perms-callout\">Requires the Basic [16] user role or the `ASSET_INVENTORY.CYBER_ASSET_MANAGEMENT.READ` and `AD.TOGGLE_AD.USE` custom role privileges. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List asset properties",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/api/v1/t1/inventory/assets/properties",
            "params": [
              {
                "name": "asset_classes",
                "value": "",
                "type": "query",
                "description": "The asset classes you want to retrieve property filters for. If this parameter is omitted, Tenable Exposure Management returns property filters for all asset classes.\n\nAsset classes enable users to easily separate asset data based on its type. For more information about asset classes, see [Asset Classes](https://docs.tenable.com/exposure-management/Content/exposure-management/inventory/classes.htm) in the Tenable Exposure Management User Guide."
              }
            ]
          },
          "docs": "Returns a list of asset properties that can be used as filters on endpoints that support them. For example, the properties that are returned by this endpoint can be used as filters for the [Search assets](ref:inventory-assets-search) or [Export assets](ref:inventory-export-assets) endpoints.\n\n In addition to the asset properties, the results list includes the logical operators you can use with the asset properties along with the supported values.\n\n**Caution:** This endpoint is available for use "
        },
        {
          "info": {
            "name": "List finding properties",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/api/v1/t1/inventory/findings/properties"
          },
          "docs": "Returns a list of finding properties that can be used for filters on endpoints that support them. For example, the properties that are returned by this endpoint can be used as filters for the [Export findings](ref:inventory-export-findings) endpoint.\n\n  In addition to the finding properties, the results list includes the logical operators you can use with the finding properties along with the supported values.\n\n**Caution:** This endpoint is available for use but is currently in beta. The respons"
        },
        {
          "info": {
            "name": "List software properties",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/api/v1/t1/inventory/software/properties"
          },
          "docs": "Returns a list of software properties that can be used for filters on endpoints that support them. For example, the properties that are returned by this endpoint can be used as filters for the [Search software](ref:inventory-software-search) endpoint.\n\n  In addition to the software properties, the results list includes the logical operators you can use with the tag properties along with the supported values.\n\n**Caution:** This endpoint is available for use but is currently in beta. The response "
        }
      ]
    }
  ],
  "bundled": true
}