Changelog
Back to All
Added

SaaS Management: App Utilization Dashboards

August 27th, 2026

Summary

You can now pull per-app utilization data for your clients through the Lifecycle Manager API — the same data backing the SaaS Management app dashboard. Three new endpoints return app-by-app usage metrics, an optional per-app breakdown of top users, and a lifecycle time series that buckets apps into risk, approval, and usage segments over time. The two dashboard endpoints support filtering by app, user, department, category, vendor, approval status, and compliance criteria, plus free-text app search, sorting, comparison periods, and cursor pagination; the time series endpoint supports department and approval-status filters.

SaaS Management is a subscription feature: requests for a client without an active SaaS Management subscription return 402 Payment Required.

These are new endpoints only — nothing else in the API changes, and the version stays v1.

Changes

New endpoints

SaaS Management

  • GET /lifecycle-manager/v1/saas-management/clients/{client_id}/apps/utilization

    • N/A → Available
    • Type: addition
    • Notes: Returns one row per app the client used in the reporting period, with usage metrics (unique users, active time, sessions), certifications, and lifecycle classification. Set a comparison period to get change-over-time deltas on each metric.

  • GET /lifecycle-manager/v1/saas-management/clients/{client_id}/apps/utilization/users

    • N/A → Available
    • Type: addition
    • Notes: Same rows and filters as the base utilization endpoint, with each app row additionally carrying its top users by average time. Use it only when the per-user breakdown is needed — it is more expensive than the base endpoint.

  • GET /lifecycle-manager/v1/saas-management/clients/{client_id}/apps/utilization/timeseries

    • N/A → Available
    • Type: addition
    • Notes: Returns app counts per time bucket across five mutually exclusive lifecycle segments — risky, unapproved, and AI apps, with the remaining apps split into actively used and unused — at daily, weekly, monthly, or quarterly granularity.

Dates

  • Effective: [2026-08-27]