Reports

Export project SBOM report asynchronously (Dependencies - SCA)

Changed on
post/api/v3.0/projects/{projectUuid}/dependencies/reports/SBOM

Request

Path parameters

projectUuidstring required

UUID of the project

Request body

namestring
format'json' | 'html' | 'unknown' | 'xml' | 'excel' | 'yaml' | 'pdf' | 'tv' | 'rdf' | 'csv' | 'sarif' | 'text'
sendEmailNotificationboolean
reportType'attribution' | 'inventory' | 'vulnerabilities' | 'securityAlerts' | 'sbom' | 'Cbom' | 'securityAlertsLibrary' | 'Compliance' | 'Findings' | 'Suppressions' | 'Resolved' | 'spdx' | 'spdx_2_3' | 'cycloneDX' | 'cycloneDX_1_5' | 'cycloneDX_1_6' | 'dueDiligence' | 'unknown' | 'imgAttribution' | 'imgDueDiligence' | 'imgSpdx' | 'imgSpdx_2_3' | 'imgCycloneDX' | 'imgCycloneDX_1_5' | 'aiInventory' | 'aiFindings' | 'aiBom' | 'aiEntities' | 'conversationalSystemPrompts' | 'imgCycloneDX_1_6' | 'risk' | 'users' | 'zeroDayCatalog' | 'activityLog' | 'unifiedFindings' | 'spdx' | 'spdx_2_3' | 'cycloneDX' | 'cycloneDX_1_5' | 'cycloneDX_1_6'

SBOM report type. Only SPDX and CycloneDX variants are valid for this endpoint.

maxDepthLevelinteger

Maximum depth level of the dependency tree to include in the report. Applies to CycloneDX variants only and must be between 1 and 4; values outside this range (including 0) are rejected with a 400 error. Ignored for SPDX variants.

includeVulnerabilitiesboolean
isMlBomReportboolean

When true, generates an ML-BOM (AI/ML Bill of Materials) that includes only machine-learning model components. If the selected scope contains no ML/AI model components, the generated report will be empty (for CycloneDX/SPDX this yields an empty ZIP). Defaults to false.

componentGranularity'library' | 'file'

Component granularity: 'library' (default) or 'file' for source-file-level coverage

reportStructure'PER_PROJECT' | 'AGGREGATED' | 'PER_PROJECT'

How the report is split over files. A project scope always produces one file, so 'PER_PROJECT' is the only accepted value here; 'AGGREGATED' is rejected with a 400 error.

Example request

{
  "reportType": "spdx",
  "maxDepthLevel": 1,
  "componentGranularity": "library",
  "reportStructure": "PER_PROJECT"
}

Response

OK

supportTokenstring

Example response

{
  "supportToken": "1171c60d"
}

Changes

    • breaking

      removed the enum value aiConversational of the request property

    • breaking

      removed the enum value aiDataExport of the request property

    • warning

      added the new aiEntities enum value to the / response property for the response status

    • warning

      added the new conversationalSystemPrompts enum value to the / response property for the response status

    • info

      added the new optional request property

    • info

      added the new aiEntities enum value to the request property

    • info

      added the new conversationalSystemPrompts enum value to the request property

    • info

      removed the aiConversational enum value from the / response property for the response status

    • info

      removed the aiDataExport enum value from the / response property for the response status

    • warning

      added the new aiConversational enum value to the / response property for the response status

    • warning

      added the new aiDataExport enum value to the / response property for the response status

    • info

      added the new aiConversational enum value to the request property

    • info

      added the new aiDataExport enum value to the request property