get_ci_relationships
Return upstream (dependencies) and downstream (dependents) relationships for a configuration item, with details on each related CI's name, class, and operational status.
Instructions
Get all relationships for a configuration item.
Returns upstream (CIs this CI depends on), downstream (CIs that depend on this CI), or both. Each relationship includes the related CI's name, class, and operational status, plus the relationship type descriptor.
In ServiceNow CMDB relationships:
Upstream: this CI is the CHILD in the relationship (e.g., "Runs on" a server)
Downstream: this CI is the PARENT (e.g., a server that other CIs "Run on")
Prerequisites: Use search_cis to find the CI sys_id first. This tool only accepts sys_id (a 32-character hex identifier), not CI names. To look up a CI by name: search_cis(name_filter="my-server") → use the returned sys_id.
Examples: get_ci_relationships(ci_sys_id="abc123...", direction="downstream", limit=10) get_ci_relationships(ci_sys_id="abc123...", direction="upstream") get_ci_relationships(ci_sys_id="abc123...", direction="both", limit=50)
Args: ci_sys_id: The 32-character sys_id of the CI (from search_cis or query_cis_raw). direction: Which relationships to return: "upstream", "downstream", or "both". Defaults to "both". limit: Maximum relationships to return per direction (1-1000, default 25). offset: Pagination offset.
Returns: JSON object with "ci_sys_id", "direction", "count", and "relationships" list.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ci_sys_id | Yes | ||
| direction | No | both | |
| limit | No | ||
| offset | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |