Skip to main content
POST
Get service map summary

Restrictions

Usage

  • ServiceMap is an optional subsystem: a deployment without redis.servicemap configured returns ServiceUnavailable.
  • anchor.host_id must already be known to ServiceMap; otherwise this returns ResourceNotFound.
  • This is a fixed-size digest, not a scaled-down POST /monit/servicemap/topology: depth is always 1 and neighbors are capped at 12, and none of the sizing is caller-adjustable.
  • context_ref_detail is a pre-rendered natural-language evidence string designed for LLM prompts; the structured fields are the source of truth and this is a convenience rendering of them.
  • graph_role=last_known_good means the latest ingestion is unhealthy and the summary reflects the last authoritative graph rather than a live one.

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 bounded, AI-ready dependency summary.

anchor
object
required

Host (and optional entity) to summarize.

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.

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 bounded, AI-ready summary of a host's outbound service dependencies.