Skip to main content
API Explorer|API Explorer
Security & Audit/Security
GETSecuritySince 1.0SynchronousAuth Required

GetPostureDashboard

Get security posture dashboard overview with aggregated metrics.

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Request Inputs

This API requires no request parameters.

Responses

200 OK

On success, this API returns the following response structure.

  • totalAgentsInteger

    Total number of managed agents in the system

    Example: 200

  • vulnerableAgentsInteger

    Number of agents with at least one vulnerability finding

    Example: 35

  • criticalCveCountInteger

    Total number of distinct critical CVEs across all agents

    Example: 5

  • highCveCountInteger

    Total number of distinct high-severity CVEs across all agents

    Example: 12

  • avgCvssScoreLong

    Average CVSS score across all active findings

    Example: 7.4

  • fixRatePct30dLong

    Percentage of vulnerabilities fixed in the last 30 days

    Example: 68.5

  • top5CvesList

    Top 5 CVEs ranked by number of affected agents

    Example: (nested array)

    • cveIdString

      CVE identifier for this summary entry

      Example: CVE-2021-44228

    • affectedCountInteger

      Number of agents affected by this CVE

      Example: 15

    • severityString

      Severity level of this CVE

      Example: CVE_SEVERITY_UNSPECIFIED

Endpoint

GET/api/v1/security/posture-dashboard

/api/v1/security/posture-dashboard

Operation ID

GetPostureDashboard

Permalink

Request Example

curl -X GET '{host}/api/v1/security/posture-dashboard' -H 'Authorization: Bearer {token}'

Response Example

200
{
  "totalAgents": 200,
  "vulnerableAgents": 35,
  "criticalCveCount": 5,
  "highCveCount": 12,
  "avgCvssScore": 7.4,
  "fixRatePct30d": 68.5,
  "top5Cves": [
    {}
  ]
}

Change History

This API has no change history records yet.

View all change history