Browse service map fleet hosts

curl --request POST \
  --url 'https://api.flashcat.cloud/monit/servicemap/fleet?app_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "limit": 50,
  "scan_limit": 1000,
  "statuses": [
    "degraded",
    "stale"
  ],
  "agent_versions": [
    "v1.2.3"
  ],
  "edge_clusters": [
    "edge-a"
  ],
  "capture_modes": [
    "ebpf"
  ]
}
'

import requests

url = "https://api.flashcat.cloud/monit/servicemap/fleet?app_key="

payload = {
    "limit": 50,
    "scan_limit": 1000,
    "statuses": ["degraded", "stale"],
    "agent_versions": ["v1.2.3"],
    "edge_clusters": ["edge-a"],
    "capture_modes": ["ebpf"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    limit: 50,
    scan_limit: 1000,
    statuses: ['degraded', 'stale'],
    agent_versions: ['v1.2.3'],
    edge_clusters: ['edge-a'],
    capture_modes: ['ebpf']
  })
};

fetch('https://api.flashcat.cloud/monit/servicemap/fleet?app_key=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flashcat.cloud/monit/servicemap/fleet?app_key=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'limit' => 50,
    'scan_limit' => 1000,
    'statuses' => [
        'degraded',
        'stale'
    ],
    'agent_versions' => [
        'v1.2.3'
    ],
    'edge_clusters' => [
        'edge-a'
    ],
    'capture_modes' => [
        'ebpf'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flashcat.cloud/monit/servicemap/fleet?app_key="

	payload := strings.NewReader("{\n  \"limit\": 50,\n  \"scan_limit\": 1000,\n  \"statuses\": [\n    \"degraded\",\n    \"stale\"\n  ],\n  \"agent_versions\": [\n    \"v1.2.3\"\n  ],\n  \"edge_clusters\": [\n    \"edge-a\"\n  ],\n  \"capture_modes\": [\n    \"ebpf\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/monit/servicemap/fleet?app_key=")
  .header("Content-Type", "application/json")
  .body("{\n  \"limit\": 50,\n  \"scan_limit\": 1000,\n  \"statuses\": [\n    \"degraded\",\n    \"stale\"\n  ],\n  \"agent_versions\": [\n    \"v1.2.3\"\n  ],\n  \"edge_clusters\": [\n    \"edge-a\"\n  ],\n  \"capture_modes\": [\n    \"ebpf\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flashcat.cloud/monit/servicemap/fleet?app_key=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"limit\": 50,\n  \"scan_limit\": 1000,\n  \"statuses\": [\n    \"degraded\",\n    \"stale\"\n  ],\n  \"agent_versions\": [\n    \"v1.2.3\"\n  ],\n  \"edge_clusters\": [\n    \"edge-a\"\n  ],\n  \"capture_modes\": [\n    \"ebpf\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "data": {
    "items": [
      {
        "host_id": "host_0123456789abcdef0123456789abcdef",
        "agent_version": "v1.2.3",
        "edge_cluster": "edge-a",
        "servicemap": {
          "enabled": true,
          "status": "degraded",
          "capability_status": "degraded",
          "capture_mode": "ebpf",
          "snapshot_ready": true,
          "authoritative": true,
          "graph_available": false,
          "freshness_status": "fresh",
          "observed_at_ms": 1784635557272,
          "received_at_ms": 1784635557272,
          "node_count": 46,
          "edge_count": 200,
          "reason_codes": [
            "snapshot_incomplete"
          ]
        }
      },
      {
        "host_id": "host_fedcba9876543210fedcba9876543210",
        "agent_version": "v1.2.3",
        "edge_cluster": "edge-a",
        "servicemap": {
          "enabled": true,
          "status": "stale",
          "capability_status": "running",
          "capture_mode": "ebpf",
          "snapshot_ready": true,
          "authoritative": true,
          "graph_available": true,
          "freshness_status": "stale",
          "observed_at_ms": 1784631957272,
          "received_at_ms": 1784631957272,
          "node_count": 38,
          "edge_count": 152
        }
      }
    ],
    "coverage": {
      "scanned": 80,
      "matched": 2,
      "returned": 2,
      "failed": 0,
      "states": {
        "active": 0,
        "degraded": 1,
        "stale": 1,
        "initializing": 0,
        "disabled": 0,
        "unsupported": 0,
        "no_data": 0
      }
    },
    "partial": false,
    "truncated": false,
    "generated_at_ms": 1784635557272
  }
}

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "error": {
    "code": "InvalidParameter",
    "message": "The specified parameter is not valid."
  }
}

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "error": {
    "code": "Unauthorized",
    "message": "You are unauthorized."
  }
}

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "error": {
    "code": "RequestTooFrequently",
    "message": "Request too frequently."
  }
}

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "error": {
    "code": "InternalError",
    "message": "We encountered an internal error, and it has been reported. Please try again later."
  }
}

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "error": {
    "code": "ServiceUnavailable",
    "message": "servicemap store is not initialized"
  }
}

POST

monit

servicemap

fleet

Browse service map fleet hosts

curl --request POST \
  --url 'https://api.flashcat.cloud/monit/servicemap/fleet?app_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "limit": 50,
  "scan_limit": 1000,
  "statuses": [
    "degraded",
    "stale"
  ],
  "agent_versions": [
    "v1.2.3"
  ],
  "edge_clusters": [
    "edge-a"
  ],
  "capture_modes": [
    "ebpf"
  ]
}
'

import requests

url = "https://api.flashcat.cloud/monit/servicemap/fleet?app_key="

payload = {
    "limit": 50,
    "scan_limit": 1000,
    "statuses": ["degraded", "stale"],
    "agent_versions": ["v1.2.3"],
    "edge_clusters": ["edge-a"],
    "capture_modes": ["ebpf"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    limit: 50,
    scan_limit: 1000,
    statuses: ['degraded', 'stale'],
    agent_versions: ['v1.2.3'],
    edge_clusters: ['edge-a'],
    capture_modes: ['ebpf']
  })
};

fetch('https://api.flashcat.cloud/monit/servicemap/fleet?app_key=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flashcat.cloud/monit/servicemap/fleet?app_key=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'limit' => 50,
    'scan_limit' => 1000,
    'statuses' => [
        'degraded',
        'stale'
    ],
    'agent_versions' => [
        'v1.2.3'
    ],
    'edge_clusters' => [
        'edge-a'
    ],
    'capture_modes' => [
        'ebpf'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flashcat.cloud/monit/servicemap/fleet?app_key="

	payload := strings.NewReader("{\n  \"limit\": 50,\n  \"scan_limit\": 1000,\n  \"statuses\": [\n    \"degraded\",\n    \"stale\"\n  ],\n  \"agent_versions\": [\n    \"v1.2.3\"\n  ],\n  \"edge_clusters\": [\n    \"edge-a\"\n  ],\n  \"capture_modes\": [\n    \"ebpf\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/monit/servicemap/fleet?app_key=")
  .header("Content-Type", "application/json")
  .body("{\n  \"limit\": 50,\n  \"scan_limit\": 1000,\n  \"statuses\": [\n    \"degraded\",\n    \"stale\"\n  ],\n  \"agent_versions\": [\n    \"v1.2.3\"\n  ],\n  \"edge_clusters\": [\n    \"edge-a\"\n  ],\n  \"capture_modes\": [\n    \"ebpf\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flashcat.cloud/monit/servicemap/fleet?app_key=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"limit\": 50,\n  \"scan_limit\": 1000,\n  \"statuses\": [\n    \"degraded\",\n    \"stale\"\n  ],\n  \"agent_versions\": [\n    \"v1.2.3\"\n  ],\n  \"edge_clusters\": [\n    \"edge-a\"\n  ],\n  \"capture_modes\": [\n    \"ebpf\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "data": {
    "items": [
      {
        "host_id": "host_0123456789abcdef0123456789abcdef",
        "agent_version": "v1.2.3",
        "edge_cluster": "edge-a",
        "servicemap": {
          "enabled": true,
          "status": "degraded",
          "capability_status": "degraded",
          "capture_mode": "ebpf",
          "snapshot_ready": true,
          "authoritative": true,
          "graph_available": false,
          "freshness_status": "fresh",
          "observed_at_ms": 1784635557272,
          "received_at_ms": 1784635557272,
          "node_count": 46,
          "edge_count": 200,
          "reason_codes": [
            "snapshot_incomplete"
          ]
        }
      },
      {
        "host_id": "host_fedcba9876543210fedcba9876543210",
        "agent_version": "v1.2.3",
        "edge_cluster": "edge-a",
        "servicemap": {
          "enabled": true,
          "status": "stale",
          "capability_status": "running",
          "capture_mode": "ebpf",
          "snapshot_ready": true,
          "authoritative": true,
          "graph_available": true,
          "freshness_status": "stale",
          "observed_at_ms": 1784631957272,
          "received_at_ms": 1784631957272,
          "node_count": 38,
          "edge_count": 152
        }
      }
    ],
    "coverage": {
      "scanned": 80,
      "matched": 2,
      "returned": 2,
      "failed": 0,
      "states": {
        "active": 0,
        "degraded": 1,
        "stale": 1,
        "initializing": 0,
        "disabled": 0,
        "unsupported": 0,
        "no_data": 0
      }
    },
    "partial": false,
    "truncated": false,
    "generated_at_ms": 1784635557272
  }
}

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "error": {
    "code": "InvalidParameter",
    "message": "The specified parameter is not valid."
  }
}

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "error": {
    "code": "Unauthorized",
    "message": "You are unauthorized."
  }
}

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "error": {
    "code": "RequestTooFrequently",
    "message": "Request too frequently."
  }
}

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "error": {
    "code": "InternalError",
    "message": "We encountered an internal error, and it has been reported. Please try again later."
  }
}

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "error": {
    "code": "ServiceUnavailable",
    "message": "servicemap store is not initialized"
  }
}

Restrictions

Aspect	Value
Rate limits	30 requests/minute; 2 requests/second per account
Permissions	Targets Read (`monit`)

Usage

Unlike the other four ServiceMap read APIs, this endpoint degrades gracefully when the ServiceMap store is unavailable: matching still runs off inventory data, and affected items report servicemap.error_code=status_unavailable with partial=true, instead of the whole request failing.
cursor is opaque — pass back the exact value from next_cursor; do not construct or parse it.
Reaching scan_limit before limit matches are found sets truncated=true with next_cursor still populated — this is not the same as reaching the end of the account’s hosts.
coverage.scanned/matched/returned describe this page’s scan only, not the account’s total host population.

Authorizations

app_key

string

query

required

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

application/json

Filter and pagination parameters for browsing ServiceMap-capable hosts.

cursor

string

Opaque pagination cursor. Pass back the exact value from a previous response's next_cursor; omit for the first page.

limit

integer

default:50

Maximum number of matching hosts to return in this page. Default 50, range 1-100.

Required range: 1 <= x <= 100

scan_limit

integer

default:1000

Maximum number of candidate hosts to examine while filling this page. Default 1000, range limit-2000.

Required range: x <= 2000

statuses

enum<string>[]

Filter to hosts currently in any of these statuses. Up to 20 values.

Maximum array length: 20

Available options:

active,

degraded,

stale,

initializing,

disabled,

unsupported,

no_data

agent_versions

string[]

Filter to hosts on any of these exact agent versions. Up to 20 values.

Maximum array length: 20

edge_clusters

string[]

Filter to hosts in any of these exact edge cluster names. Up to 20 values.

Maximum array length: 20

capture_modes

enum<string>[]

Filter to hosts using any of these capture modes. unknown matches hosts that have not reported a capture mode yet.

Maximum array length: 3

Available options:

ebpf,

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.

request_id

string

required

Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data

object

required

A page of hosts matching the fleet browse filters.

Show child attributes

Developer Guide

On-call

Monitors

RUM

AI SRE

Platform

Browse service map fleet hosts

Restrictions

Usage

Authorizations

Body

Response

​Restrictions

​Usage

Authorizations

Body

Response

Restrictions

Usage