Get service map topology

curl --request POST \
  --url 'https://api.flashcat.cloud/monit/servicemap/topology?app_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "anchor": {
    "host_id": "host_0123456789abcdef0123456789abcdef"
  },
  "depth": 2,
  "max_nodes": 100,
  "max_edges": 200,
  "include_metrics": true,
  "unresolved_mode": "full"
}
'

import requests

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

payload = {
    "anchor": { "host_id": "host_0123456789abcdef0123456789abcdef" },
    "depth": 2,
    "max_nodes": 100,
    "max_edges": 200,
    "include_metrics": True,
    "unresolved_mode": "full"
}
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({
    anchor: {host_id: 'host_0123456789abcdef0123456789abcdef'},
    depth: 2,
    max_nodes: 100,
    max_edges: 200,
    include_metrics: true,
    unresolved_mode: 'full'
  })
};

fetch('https://api.flashcat.cloud/monit/servicemap/topology?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/topology?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([
    'anchor' => [
        'host_id' => 'host_0123456789abcdef0123456789abcdef'
    ],
    'depth' => 2,
    'max_nodes' => 100,
    'max_edges' => 200,
    'include_metrics' => true,
    'unresolved_mode' => 'full'
  ]),
  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/topology?app_key="

	payload := strings.NewReader("{\n  \"anchor\": {\n    \"host_id\": \"host_0123456789abcdef0123456789abcdef\"\n  },\n  \"depth\": 2,\n  \"max_nodes\": 100,\n  \"max_edges\": 200,\n  \"include_metrics\": true,\n  \"unresolved_mode\": \"full\"\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/topology?app_key=")
  .header("Content-Type", "application/json")
  .body("{\n  \"anchor\": {\n    \"host_id\": \"host_0123456789abcdef0123456789abcdef\"\n  },\n  \"depth\": 2,\n  \"max_nodes\": 100,\n  \"max_edges\": 200,\n  \"include_metrics\": true,\n  \"unresolved_mode\": \"full\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flashcat.cloud/monit/servicemap/topology?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  \"anchor\": {\n    \"host_id\": \"host_0123456789abcdef0123456789abcdef\"\n  },\n  \"depth\": 2,\n  \"max_nodes\": 100,\n  \"max_edges\": 200,\n  \"include_metrics\": true,\n  \"unresolved_mode\": \"full\"\n}"

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

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "data": {
    "network_scope_id": "ns_0123456789abcdef0123456789abcdef",
    "anchor_host_id": "host_0123456789abcdef0123456789abcdef",
    "observed_at_ms": 1784635556072,
    "freshness": {
      "status": "fresh",
      "newest_received_at_ms": 1784635557272,
      "oldest_received_at_ms": 1784635557272,
      "max_age_ms": 1200
    },
    "coverage": {
      "direction": "outbound",
      "hosts_loaded": 2,
      "degraded_hosts": 0,
      "truncated_hosts": 0,
      "capture_modes": [
        "ebpf"
      ],
      "network_inventory_status": "complete",
      "kubernetes_enrichment_status": "unavailable",
      "listener_address_family_status": "complete",
      "ipv6_wildcard_listener_count": 0,
      "ipv6_only_known_listener_count": 0,
      "ipv6_only_unknown_listener_count": 0
    },
    "truncated": false,
    "nodes": [
      {
        "host_id": "host_0123456789abcdef0123456789abcdef",
        "id": "procw_v1_source",
        "kind": "process",
        "display_name": "orders.service",
        "systemd_unit": "orders.service",
        "first_seen": "2026-07-01T02:00:00Z",
        "last_seen": "2026-07-21T18:45:56.072+08:00"
      },
      {
        "host_id": "host_fedcba9876543210fedcba9876543210",
        "id": "procw_v1_mysql",
        "kind": "process",
        "display_name": "mysqld.service",
        "systemd_unit": "mysqld.service",
        "first_seen": "2026-07-01T02:00:00Z",
        "last_seen": "2026-07-21T18:45:56.072+08:00"
      }
    ],
    "edges": [
      {
        "host_id": "host_0123456789abcdef0123456789abcdef",
        "id": "edge_v1_example",
        "source_entity_id": "procw_v1_source",
        "source_netns_id": "netns_v1_default",
        "destination": {
          "ip": "203.0.113.105",
          "port": 3306,
          "protocol": "tcp"
        },
        "evidence": "connect",
        "last_seen": "2026-07-21T18:45:56.072+08:00",
        "depth": 1,
        "endpoint_resolution": {
          "status": "resolved",
          "endpoint": {
            "ip": "203.0.113.105",
            "port": 3306,
            "protocol": "tcp"
          },
          "candidates": [
            {
              "host_id": "host_fedcba9876543210fedcba9876543210",
              "entity_id": "procw_v1_mysql",
              "netns_id": "netns_v1_default",
              "listener_id": "listener_v1_mysql",
              "listener_ip": "203.0.113.105",
              "effective_ip": "203.0.113.105",
              "protocol": "tcp",
              "port": 3306,
              "match_kind": "exact",
              "confidence": 1,
              "node_kind": "process",
              "node_display_name": "mysqld.service",
              "graph_sequence": 42,
              "observed_at_ms": 1784635556072
            }
          ]
        }
      }
    ],
    "unresolved_endpoints": [],
    "resolution_counts": {
      "resolved": 1,
      "ambiguous": 0,
      "unresolved": 0
    },
    "unresolved_projection": {
      "mode": "full",
      "total": 0,
      "returned": 0,
      "omitted": 0,
      "by_reason": []
    }
  }
}

{
  "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

topology

Get service map topology

curl --request POST \
  --url 'https://api.flashcat.cloud/monit/servicemap/topology?app_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "anchor": {
    "host_id": "host_0123456789abcdef0123456789abcdef"
  },
  "depth": 2,
  "max_nodes": 100,
  "max_edges": 200,
  "include_metrics": true,
  "unresolved_mode": "full"
}
'

import requests

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

payload = {
    "anchor": { "host_id": "host_0123456789abcdef0123456789abcdef" },
    "depth": 2,
    "max_nodes": 100,
    "max_edges": 200,
    "include_metrics": True,
    "unresolved_mode": "full"
}
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({
    anchor: {host_id: 'host_0123456789abcdef0123456789abcdef'},
    depth: 2,
    max_nodes: 100,
    max_edges: 200,
    include_metrics: true,
    unresolved_mode: 'full'
  })
};

fetch('https://api.flashcat.cloud/monit/servicemap/topology?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/topology?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([
    'anchor' => [
        'host_id' => 'host_0123456789abcdef0123456789abcdef'
    ],
    'depth' => 2,
    'max_nodes' => 100,
    'max_edges' => 200,
    'include_metrics' => true,
    'unresolved_mode' => 'full'
  ]),
  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/topology?app_key="

	payload := strings.NewReader("{\n  \"anchor\": {\n    \"host_id\": \"host_0123456789abcdef0123456789abcdef\"\n  },\n  \"depth\": 2,\n  \"max_nodes\": 100,\n  \"max_edges\": 200,\n  \"include_metrics\": true,\n  \"unresolved_mode\": \"full\"\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/topology?app_key=")
  .header("Content-Type", "application/json")
  .body("{\n  \"anchor\": {\n    \"host_id\": \"host_0123456789abcdef0123456789abcdef\"\n  },\n  \"depth\": 2,\n  \"max_nodes\": 100,\n  \"max_edges\": 200,\n  \"include_metrics\": true,\n  \"unresolved_mode\": \"full\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flashcat.cloud/monit/servicemap/topology?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  \"anchor\": {\n    \"host_id\": \"host_0123456789abcdef0123456789abcdef\"\n  },\n  \"depth\": 2,\n  \"max_nodes\": 100,\n  \"max_edges\": 200,\n  \"include_metrics\": true,\n  \"unresolved_mode\": \"full\"\n}"

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

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "data": {
    "network_scope_id": "ns_0123456789abcdef0123456789abcdef",
    "anchor_host_id": "host_0123456789abcdef0123456789abcdef",
    "observed_at_ms": 1784635556072,
    "freshness": {
      "status": "fresh",
      "newest_received_at_ms": 1784635557272,
      "oldest_received_at_ms": 1784635557272,
      "max_age_ms": 1200
    },
    "coverage": {
      "direction": "outbound",
      "hosts_loaded": 2,
      "degraded_hosts": 0,
      "truncated_hosts": 0,
      "capture_modes": [
        "ebpf"
      ],
      "network_inventory_status": "complete",
      "kubernetes_enrichment_status": "unavailable",
      "listener_address_family_status": "complete",
      "ipv6_wildcard_listener_count": 0,
      "ipv6_only_known_listener_count": 0,
      "ipv6_only_unknown_listener_count": 0
    },
    "truncated": false,
    "nodes": [
      {
        "host_id": "host_0123456789abcdef0123456789abcdef",
        "id": "procw_v1_source",
        "kind": "process",
        "display_name": "orders.service",
        "systemd_unit": "orders.service",
        "first_seen": "2026-07-01T02:00:00Z",
        "last_seen": "2026-07-21T18:45:56.072+08:00"
      },
      {
        "host_id": "host_fedcba9876543210fedcba9876543210",
        "id": "procw_v1_mysql",
        "kind": "process",
        "display_name": "mysqld.service",
        "systemd_unit": "mysqld.service",
        "first_seen": "2026-07-01T02:00:00Z",
        "last_seen": "2026-07-21T18:45:56.072+08:00"
      }
    ],
    "edges": [
      {
        "host_id": "host_0123456789abcdef0123456789abcdef",
        "id": "edge_v1_example",
        "source_entity_id": "procw_v1_source",
        "source_netns_id": "netns_v1_default",
        "destination": {
          "ip": "203.0.113.105",
          "port": 3306,
          "protocol": "tcp"
        },
        "evidence": "connect",
        "last_seen": "2026-07-21T18:45:56.072+08:00",
        "depth": 1,
        "endpoint_resolution": {
          "status": "resolved",
          "endpoint": {
            "ip": "203.0.113.105",
            "port": 3306,
            "protocol": "tcp"
          },
          "candidates": [
            {
              "host_id": "host_fedcba9876543210fedcba9876543210",
              "entity_id": "procw_v1_mysql",
              "netns_id": "netns_v1_default",
              "listener_id": "listener_v1_mysql",
              "listener_ip": "203.0.113.105",
              "effective_ip": "203.0.113.105",
              "protocol": "tcp",
              "port": 3306,
              "match_kind": "exact",
              "confidence": 1,
              "node_kind": "process",
              "node_display_name": "mysqld.service",
              "graph_sequence": 42,
              "observed_at_ms": 1784635556072
            }
          ]
        }
      }
    ],
    "unresolved_endpoints": [],
    "resolution_counts": {
      "resolved": 1,
      "ambiguous": 0,
      "unresolved": 0
    },
    "unresolved_projection": {
      "mode": "full",
      "total": 0,
      "returned": 0,
      "omitted": 0,
      "by_reason": []
    }
  }
}

{
  "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	20 requests/minute; 1 request/second per account
Permissions	Service Map Read (`monit`)

Usage

ServiceMap is an optional subsystem: a deployment without redis.servicemap configured returns ServiceUnavailable.
at currently only accepts now (or empty, which behaves identically).
direction currently only accepts outbound (or empty).
anchor.host_id must already be known to ServiceMap (have a current or recently retired graph); otherwise this returns ResourceNotFound.
depth (max 3), max_nodes (max 500), and max_edges (max 1000) bound the traversal; when a bound is hit, truncated=true and truncation_reasons explains why.
unresolved_mode=summary (vs. the default full) omits unresolved edges from edges and returns only a bounded sample in unresolved_endpoints.

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

Query parameters for the outbound topology traversal.

anchor

object

required

Host (and optional entity) to start the traversal from.

Show child attributes

network_scope_id

string

Optional integrity check: if set, must match the network scope already associated with anchor.host_id, or the request is rejected with InvalidParameter.

enum<string>

Time selector for the query. Only now is currently supported; omitting the field behaves the same.

Available options:

now

direction

enum<string>

Traversal direction. Only outbound is currently supported; omitting the field behaves the same.

Available options:

outbound

depth

integer

default:1

Maximum traversal depth from the anchor. Default 1, maximum 3.

Required range: x <= 3

max_nodes

integer

default:100

Maximum number of nodes to return before truncating. Default 100, maximum 500.

Required range: x <= 500

max_edges

integer

default:200

Maximum number of edges to examine before truncating. Default 200, maximum 1000.

Required range: x <= 1000

include_metrics

boolean

default:false

Whether to include the raw per-edge metrics payload in the response. Default false.

unresolved_mode

enum<string>

default:full

How unresolved edges are projected. full (default) includes them in edges and unresolved_endpoints; summary omits them from edges and returns only a bounded sample in unresolved_endpoints.

Available options:

summary,

full

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

The outbound dependency graph discovered around the anchor host.

Show child attributes

Developer Guide

On-call

Monitors

RUM

AI SRE

Platform

Get service map topology

Restrictions

Usage

Authorizations

Body

Response

​Restrictions

​Usage

Authorizations

Body

Response

Restrictions

Usage