Get service map fleet summary
Return an aggregate status distribution across the account’s ServiceMap-capable hosts.
Restrictions
Usage
- Like
POST /monit/servicemap/fleet, this endpoint degrades gracefully when the ServiceMap store is unavailable rather than failing the whole request. - This is a single-request, unpaginated aggregate over up to
scan_limithosts (default 2000, max 5000) — it does not return per-host detail or accept a status filter. - Reaching
scan_limitbefore scanning the whole account setstruncated=true;coverage.statesreflects only the hosts actually scanned, not the account’s full population.
Authorizations
App key issued from the Flashduty console under Account → APP Keys. Required on every public API call. Keep it secret — it grants the same access as the owning account.
Body
Filter parameters for the aggregate fleet status distribution.
Maximum number of candidate hosts to scan. Default 2000, range 1-5000.
1 <= x <= 5000Filter to hosts on any of these exact agent versions. Up to 20 values.
20Filter to hosts in any of these exact edge cluster names. Up to 20 values.
20Filter to hosts using any of these capture modes. unknown matches hosts that have not reported a capture mode yet.
3ebpf, polling, unknown Response
Success
Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.