SaaS Detection and Response Release 1.16.0 API

August 20, 2026

Resource Inventory Report

You can now create Resource Inventory Reports using the Create Report API. This new report type lets you export resource inventory data — such as documents, users, groups, and applications — from your connected SaaS applications. Unlike UI-based inventory downloads, which are capped at 100,000 records, the Resource Inventory Report has no record limit and supports large-scale data exports.

Resource Inventory Reports are created through the existing Create Report API by setting the reportType parameter to INVENTORY in the config object. If reportType is not specified, it defaults to CONTROL (the existing Posture Assessment Report behavior). This ensures full backward compatibility — existing API integrations continue to work without any changes.

To create a Resource Inventory Report, use the following API:

POST – Create Resource Inventory Report

Updated API: Create Resource Inventory Report

New or Updated API	Updated
API Endpoint	/sdr/api/v1/report/create
Method	POST
DTD or XSD Changes	NA

Use this API to create a new resource inventory report by specifying the report type as INVENTORY, along with parameters such as SaaS application, connector, resource types, and output format. The report can be downloaded in CSV or PDF format. CSV output contains only the data table, while PDF output includes a summary section with charts and a data table.

Policy and Control Evaluation parameters are not applicable to Resource Inventory Reports. Omit the policy and result fields from the request body when reportType is INVENTORY.

Input ParametersInput Parameters

Parameter	Required/ Optional	Data Type	Description
reportName	Required	String	Specify the name of the report you want to generate.
description	Optional	String / Null	Specify a description that helps you identify the purpose of the report.
fileFormat	Required	String	Specify the output format for the report (CSV or PDF).
config.reportType	Required	String	Specify the report type. Use INVENTORY for resource inventory reports. Allowed values: INVENTORY, CONTROL. Default: CONTROL.
config.saasApplication.key	Required	String	Specify the identifier for the SaaS application (for example, OFFICE365).
config.saasApplication.value	Required	String	Specify the display name of the SaaS application (for example, Office 365).
config.connectors	Required	Array	Specify one or more connectors associated with your SaaS account. Each connector object contains a key (connector ID) and a value (connector name).
config.resourceTypes	Required	Array of Strings	Specify the resource types to include in the report. Allowed values: document, user, group, application.
config.template.key	Required	String	Specify the template identifier. For CSV: SDR_Resource_Inventory_CSV_Report. For PDF: SDR_Resource_Inventory_Assessment_Report.
config.template.value	Required	String	Specify the template display name. For CSV: Resource Inventory CSV Report. For PDF: Resource Inventory Assessment Report.
config.query	Optional	String	Specify a QQL query to filter resources (for example, name: 'budget*').

Sample - Create Resource Inventory Report (CSV)Sample - Create Resource Inventory Report (CSV)

API Request

curl --location --request POST '<qualys_base_url>/sdr/api/v1/report/create' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json'

Request Body

{
  "reportName": "Resource Inventory CSV Report",
  "description": "Resource inventory report in CSV format",
  "fileFormat": "csv",
  "config": {
    "reportType": "INVENTORY",
    "saasApplication": {
      "key": "OFFICE365",
      "value": "Office 365"
    },
    "connectors": [
      {
        "key": <connector_id>,
        "value": "<connector_name>"
      }
    ],
    "resourceTypes": [
      "document"
    ],
    "template": {
      "key": "SDR_Resource_Inventory_CSV_Report",
      "value": "Resource Inventory CSV Report"
    },
    "query": "name: \"budget*\""
  }
}

Response

{
  "data": {
    "fileUuid": "2eeaxxxx-b4xx-11xx-a4xx-33xxe5xx3dxx"
  },
  "message": "Request successfully created.",
  "count": null
}

Sample - Create Resource Inventory Report (PDF)Sample - Create Resource Inventory Report (PDF)

API Request

curl --location --request POST '<qualys_base_url>/sdr/api/v1/report/create' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json'

Request Body

{
  "reportName": "Resource Inventory PDF Report",
  "description": "Resource inventory assessment report in PDF format",
  "fileFormat": "pdf",
  "config": {
    "reportType": "INVENTORY",
    "saasApplication": {
      "key": "OFFICE365",
      "value": "Office 365"
    },
    "connectors": [
      {
        "key": <connector_id>,
        "value": "<connector_name>"
      }
    ],
    "resourceTypes": [
      "document"
    ],
    "template": {
      "key": "SDR_Resource_Inventory_Assessment_Report",
      "value": "Resource Inventory Assessment Report"
    },
    "query": "name: \"budget*\""
  }
}

Response

{
  "data": {
    "fileUuid": "2eeaxxxx-b4xx-11xx-a4xx-33xxe5xx3dxx"
  },
  "message": "Request successfully created.",
  "count": null
}

Last updated: August, 2026