get_ci_details
Retrieve complete details of a configuration item using its sys_id. Specify fields to get only needed attributes, or receive a broad default set including common CI fields.
Instructions
Get the full details of a single configuration item by its sys_id.
Returns all requested fields for the CI. If no fields are specified, returns a broad set of common CI attributes. Use this tool when you need complete information about a specific CI, such as after finding it via search_cis.
Prerequisites: Use search_cis or query_cis_raw to find the 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_details(sys_id="abc123...", table="cmdb_ci_server") get_ci_details(sys_id="abc123...", table="cmdb_ci_linux_server", display_value="true") get_ci_details(sys_id="abc123...", fields=["name", "ip_address", "os", "os_version"])
Args: sys_id: The 32-character sys_id of the CI record (from search_cis or query_cis_raw). table: The CMDB table the CI belongs to (e.g. cmdb_ci_server). Defaults to cmdb_ci. Using the specific class table is more efficient and returns class-specific fields. fields: Specific fields to return. If omitted, returns a broad default set including sys_id, name, sys_class_name, asset_tag, serial_number, ip_address, operational_status, install_status, location, department, company, os, os_version, cpu_count, ram, disk_space, discovery_source, first_discovered, last_discovered, sys_created_on, sys_updated_on. display_value: Controls how reference fields (location, company, assigned_to, etc.) are returned. "" (default) returns raw sys_id values. "true" returns human-readable display values (e.g. "New York" instead of a sys_id). "all" returns both as {"value": sys_id, "display_value": "New York"}. Use "true" when presenting data to users; use "all" when you need both the sys_id (for API calls) and the display name.
Returns: JSON object with the CI record fields, plus a "url" field linking to the ServiceNow record, or a NotFoundError if the sys_id does not exist. When display_value="all", each reference field is returned as {"value": sys_id, "display_value": label} instead of a plain sys_id string.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sys_id | Yes | ||
| table | No | cmdb_ci | |
| fields | No | ||
| display_value | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |