Skip to content

ASM - Attack Surface Management

View Attack Surface Management KPIs and trend data.

Commands

asm kpis

Display ASM dashboard KPIs including threat severity breakdown and asset count.

1
mysecutec asm kpis

API

Makes two API calls:

1. Threat severity aggregation: 

1
POST /tam/v1/threats/aggregate


 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
{
  "group_by": [
    { "path": "severity", "alias": "severity" }
  ],
  "select": [
    { "path": "id", "alias": "count" }
  ],
  "filters": {
    "license_module": ["asm"]
  }
}

2. Asset count: 

1
GET /tam/v1/assets/?limit=1&license_module=asm

Response Example

The CLI renders a summary table:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
ASM KPIs
────────────────────
Critical:  5
High:      15
Medium:    40
Low:       60
Info:      30
────────────────────
Total Threats: 150
Total Assets:  42

asm years

List years that have ASM threat data.

1
mysecutec asm years

API

1
POST /tam/v1/threats/aggregate

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
{
  "group_by": [
    { "path": "first_seen_at.year", "alias": "year" }
  ],
  "select": [
    { "path": "id", "alias": "count" }
  ],
  "filters": {
    "license_module": ["asm"]
  }
}

Response

1
2
3
4
5
6
{
  "results": [
    { "year": 2024, "count": 85 },
    { "year": 2025, "count": 150 }
  ]
}

asm year-kpis

View monthly threat breakdown for a specific year.

1
mysecutec asm year-kpis --year <year>

Flags

Flag Type Required Description
--year int Yes Year to query

API

1
POST /tam/v1/threats/aggregate

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
{
  "group_by": [
    { "path": "first_seen_at.year", "alias": "year" },
    { "path": "first_seen_at.month", "alias": "month" },
    { "path": "severity", "alias": "severity" }
  ],
  "select": [
    { "path": "id", "alias": "count" }
  ],
  "filters": {
    "license_module": ["asm"]
  }
}

Request Example

1
mysecutec asm year-kpis --year 2025

Response

1
2
3
4
5
6
7
8
{
  "results": [
    { "year": 2025, "month": 1, "severity": "critical", "count": 2 },
    { "year": 2025, "month": 1, "severity": "high", "count": 5 },
    { "year": 2025, "month": 2, "severity": "critical", "count": 1 },
    { "year": 2025, "month": 2, "severity": "high", "count": 8 }
  ]
}

The CLI renders this as a monthly severity breakdown table.