Added
Insight API improvements
about 4 hours ago
Insights API updates to improve Terraform and IaC compatibility and add full resource lifecycle support.
Changes:
- Added insight operations GET, POST, and DELETE on
/insights/v1/results/source/{sourceID}/insight/{insightKey}. You can now read, create/update, and delete one insight by key without relying on bulk-only flows or UI redirects. - Replaced unimplemented
page/pageSizewithpageTokenandmaxResultson list and resource-results endpoints, to align with other DoiT APIs. Large resource-result sets must be walked with tokens. - Changed field
providertocloudProvider. ResourceResultsis no longer a discriminatedoneOf, each item is a singleResourceResultobject with optional fields, using resultType to tell you which fields apply.- Money- and score-like numbers are documented and served as double-precision values so automated tools (e.g. Terraform) do not see spurious drift from rounding.
Implementation steps:
- Update any clients or generated code that uses
providerto usecloudProvider. - Adopt the flattened
ResourceResultmodel. - Switch to cursor pagination.
- Use the new singular routes where you need stable read/create/delete behavior.