Public REST API: New endpoints for findings, inventory model schema & more

25.10
highlight
Published

October 7, 2025

This release introduces new public API endpoints to list findings with filters, retrieve a single finding, manage findings schemas and payloads, fetch finding severities, and get or update the inventory model schema.

ValidMind Public REST API Reference

A web page displaying the landing page of the new ValidMind public REST API reference. The same content can be found using the link to the API reference in this section.

ValidMind Public API reference

New API endpoint to list findings with filters

You can now access all findings through a new public API. This update introduces a flexible filtering method, get_findings_with_filters, allowing you to efficiently retrieve findings based on specific criteria. Additionally, several supporting helper functions have been added to enhance your experience.

New API endpoint to retrieve a single finding

We have introduced a new public API endpoint that allows you to retrieve a single finding. This enhancement simplifies accessing specific findings, making it easier to integrate with your existing systems.

New API endpoint for findings schemas and payload updates

This update improves how you manage data by introducing a public API for handling custom fields in findings. This enhancement allows for more flexible and detailed data management across both internal and public APIs.

New API endpoint to fetch finding severities

You now have access to a new public endpoint to fetch finding severities, enhancing your ability to manage and assess organizational risks effectively.

New API endpoints to get and update inventory model schema

We have introduced enhancements to the inventory model schema functionality. You can now use the following endpoints:

  • GET organizations inventory model schema: Retrieve the current inventory model schema for organizations.
  • PUT organizations inventory model schema: Add, delete, or update custom fields within the inventory model schema.