Create a download request
Create an asynchronous export for a single resource type. The resource type is chosen by the
context field — see the context field below (DownloadContext) for the full list of
values and what each one exports. Returns a request id; poll GET /v1/downloads/{id} until the
status is completed to retrieve the presigned download URL.
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
Input object to create a download request
Selects which dataset the download request exports. The request and polling flow are identical for every value — only the returned data differs. The contexts below use the same catalog as the Working with Downloads guide, which also documents the filter and sort grammar.
oleriaUsers is an administrative context, not customer-facing identity data.
accessInventoryAccounts, accessInventoryApplicationAccountsV2, accessInventoryApplicationInstancesV2, accessInventoryEmployeesV2, accessInventoryGroupsV2, accessInventoryIdentitiesV2, accessInventoryNhiV2, accessInventoryResourceInstancesV2, accessInventoryRolesV2, accessRequests, accountUtilization, activityAnalysis, applicationAccounts, employeeAccessInsights, employees, externalAccessUsers, externalAnonymousAccess, externalSharedAssets, groupUtilizationAccounts, identities, identityAssessmentEntitlementUtilization, identityAssessmentResourceInstanceUtilization, identityAssessmentRiskDownload, identityAssessmentSimilarGroups, ilmEmployeeEvents, ilmEventAccountActions, ilmEventApplicationActions, ilmEventGroupActions, ilmWorkflowEmployeeEvents, oleriaUsers, resourceInstances, riskMonitoringDetail, risks, risksV2, unmanagedApplications, userGroup Selects the file format the download request exports. Defaults to csv when omitted.
csv, jsonl Duration that the presigned download URL is valid in minutes. Defaults to 5 minutes if no value is given. Cannot be greater than 4320 minutes (3 days).
1 <= x <= 4320Response
Download request created successfully
Tracks the status of a download request
Selects which dataset the download request exports. The request and polling flow are identical for every value — only the returned data differs. The contexts below use the same catalog as the Working with Downloads guide, which also documents the filter and sort grammar.
oleriaUsers is an administrative context, not customer-facing identity data.
accessInventoryAccounts, accessInventoryApplicationAccountsV2, accessInventoryApplicationInstancesV2, accessInventoryEmployeesV2, accessInventoryGroupsV2, accessInventoryIdentitiesV2, accessInventoryNhiV2, accessInventoryResourceInstancesV2, accessInventoryRolesV2, accessRequests, accountUtilization, activityAnalysis, applicationAccounts, employeeAccessInsights, employees, externalAccessUsers, externalAnonymousAccess, externalSharedAssets, groupUtilizationAccounts, identities, identityAssessmentEntitlementUtilization, identityAssessmentResourceInstanceUtilization, identityAssessmentRiskDownload, identityAssessmentSimilarGroups, ilmEmployeeEvents, ilmEventAccountActions, ilmEventApplicationActions, ilmEventGroupActions, ilmWorkflowEmployeeEvents, oleriaUsers, resourceInstances, riskMonitoringDetail, risks, risksV2, unmanagedApplications, userGroup Selects the file format the download request exports. Defaults to csv when omitted.
csv, jsonl accepted, completed, failed Duration that the presigned download URL is valid in minutes.
1 <= x <= 4320A presigned URL to the S3 object containing the result data.

