sn_relationships
Traverse CMDB CI relationships upstream, downstream, or both to map dependencies and analyze impact with configurable depth.
Instructions
Traverse CMDB CI relationships (graph walk). Supports upstream, downstream, or both directions with configurable depth. Use for impact analysis and dependency mapping.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"profile": "<profile>"
},
"name": "sn_relationships"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Filter by relationship type name (substring match) | |
| class | No | Filter displayed CIs by class name (substring match) | |
| depth | No | How many levels deep to traverse (1-5, default from SN_REL_DEPTH or 3) | |
| limit | No | Maximum relationships to return (default 100, max 1000) | |
| impact | No | Impact analysis mode -- walks upstream only | |
| offset | No | Deterministic traversal offset (default 0, max 1000) | |
| sys_id | No | 32-hex sys_id of the CI to start from (alternative to ci_name) | |
| ci_name | No | Name of the CI to start from (resolved via cmdb_ci name field) | |
| profile | Yes | Configured ServiceNow profile name (required; no default fallback). | |
| direction | No | Traversal direction (default: both) | both |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| profile | Yes | Configured ServiceNow profile name (required; no default fallback). | |
| metadata | Yes |