> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# servicenow-cmdb

> ServiceNow CMDB - manage configuration items, relationships, and class metadata

**Server path:** `/servicenow-cmdb` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                      | Description                       |
| ----------------------------------------------------------------------------------------- | --------------------------------- |
| [`servicenow_cmdb_add_ci_relation`](#servicenow_cmdb_add_ci_relation)                     | Add a relationship to a CI        |
| [`servicenow_cmdb_create_configuration_item`](#servicenow_cmdb_create_configuration_item) | Create a configuration item       |
| [`servicenow_cmdb_delete_ci_relation`](#servicenow_cmdb_delete_ci_relation)               | Delete a CI relationship          |
| [`servicenow_cmdb_get_class_metadata`](#servicenow_cmdb_get_class_metadata)               | Get CMDB class metadata           |
| [`servicenow_cmdb_get_configuration_item`](#servicenow_cmdb_get_configuration_item)       | Get a configuration item          |
| [`servicenow_cmdb_list_configuration_items`](#servicenow_cmdb_list_configuration_items)   | List configuration items by class |
| [`servicenow_cmdb_update_configuration_item`](#servicenow_cmdb_update_configuration_item) | Update a configuration item       |

***

## servicenow\_cmdb\_add\_ci\_relation

Add a relationship to a CI

**Parameters:**

| Parameter   | Type   | Required | Default | Description                      |
| ----------- | ------ | -------- | ------- | -------------------------------- |
| `className` | string | Yes      | —       | CMDB class name of the source CI |
| `sys_id`    | string | Yes      | —       | sys\_id of the source CI         |
| `target`    | object | Yes      | —       | Target CI for the relationship   |
| `type`      | object | Yes      | —       | Relationship type                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "className": {
        "type": "string",
        "description": "CMDB class name of the source CI"
      },
      "sys_id": {
        "type": "string",
        "description": "sys_id of the source CI"
      },
      "target": {
        "type": "object",
        "description": "Target CI for the relationship",
        "properties": {
          "value": {
            "type": "string",
            "description": "sys_id of the target CI"
          }
        },
        "required": [
          "value"
        ]
      },
      "type": {
        "type": "object",
        "description": "Relationship type",
        "properties": {
          "value": {
            "type": "string",
            "description": "sys_id of the cmdb_rel_type record"
          }
        },
        "required": [
          "value"
        ]
      }
    },
    "required": [
      "PCID",
      "className",
      "sys_id",
      "target",
      "type"
    ]
  }
  ```
</Expandable>

***

## servicenow\_cmdb\_create\_configuration\_item

Create a configuration item

**Parameters:**

| Parameter            | Type      | Required | Default | Description                                                                             |
| -------------------- | --------- | -------- | ------- | --------------------------------------------------------------------------------------- |
| `className`          | string    | Yes      | —       | CMDB class name for the new CI (e.g., cmdb\_ci\_server, cmdb\_ci\_linux\_server)        |
| `attributes`         | object    | No       | —       | CI field values (e.g., \{"name": "server01", "ip\_address": "10.0.0.1", "os": "Linux"}) |
| `inbound_relations`  | object\[] | No       | —       | Inbound relationships to create                                                         |
| `outbound_relations` | object\[] | No       | —       | Outbound relationships to create                                                        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "className": {
        "type": "string",
        "description": "CMDB class name for the new CI (e.g., cmdb_ci_server, cmdb_ci_linux_server)"
      },
      "attributes": {
        "type": "object",
        "description": "CI field values (e.g., {\"name\": \"server01\", \"ip_address\": \"10.0.0.1\", \"os\": \"Linux\"})"
      },
      "inbound_relations": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "type": {
              "type": "object",
              "description": "The type value"
            },
            "source": {
              "type": "object",
              "description": "The source value"
            }
          }
        },
        "description": "Inbound relationships to create"
      },
      "outbound_relations": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "type": {
              "type": "object",
              "description": "The type value"
            },
            "target": {
              "type": "object",
              "description": "The target value"
            }
          }
        },
        "description": "Outbound relationships to create"
      }
    },
    "required": [
      "PCID",
      "className"
    ]
  }
  ```
</Expandable>

***

## servicenow\_cmdb\_delete\_ci\_relation

Delete a CI relationship

**Parameters:**

| Parameter    | Type   | Required | Default | Description                                  |
| ------------ | ------ | -------- | ------- | -------------------------------------------- |
| `className`  | string | Yes      | —       | CMDB class name of the source CI             |
| `sys_id`     | string | Yes      | —       | sys\_id of the source CI                     |
| `rel_sys_id` | string | Yes      | —       | sys\_id of the relationship record to delete |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "className": {
        "type": "string",
        "description": "CMDB class name of the source CI"
      },
      "sys_id": {
        "type": "string",
        "description": "sys_id of the source CI"
      },
      "rel_sys_id": {
        "type": "string",
        "description": "sys_id of the relationship record to delete"
      }
    },
    "required": [
      "PCID",
      "className",
      "sys_id",
      "rel_sys_id"
    ]
  }
  ```
</Expandable>

***

## servicenow\_cmdb\_get\_class\_metadata

Get CMDB class metadata

**Parameters:**

| Parameter   | Type   | Required | Default | Description                                                  |
| ----------- | ------ | -------- | ------- | ------------------------------------------------------------ |
| `className` | string | Yes      | —       | CMDB class name to get metadata for (e.g., cmdb\_ci\_server) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "className": {
        "type": "string",
        "description": "CMDB class name to get metadata for (e.g., cmdb_ci_server)"
      }
    },
    "required": [
      "PCID",
      "className"
    ]
  }
  ```
</Expandable>

***

## servicenow\_cmdb\_get\_configuration\_item

Get a configuration item

**Parameters:**

| Parameter   | Type   | Required | Default | Description                   |
| ----------- | ------ | -------- | ------- | ----------------------------- |
| `className` | string | Yes      | —       | CMDB class name of the CI     |
| `sys_id`    | string | Yes      | —       | sys\_id of the CI to retrieve |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "className": {
        "type": "string",
        "description": "CMDB class name of the CI"
      },
      "sys_id": {
        "type": "string",
        "description": "sys_id of the CI to retrieve"
      }
    },
    "required": [
      "PCID",
      "className",
      "sys_id"
    ]
  }
  ```
</Expandable>

***

## servicenow\_cmdb\_list\_configuration\_items

List configuration items by class

**Parameters:**

| Parameter        | Type    | Required | Default | Description                                                                           |
| ---------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------- |
| `className`      | string  | Yes      | —       | CMDB class name (e.g., cmdb\_ci\_server, cmdb\_ci\_linux\_server, cmdb\_ci\_database) |
| `sysparm_query`  | string  | No       | —       | Encoded query to filter CIs                                                           |
| `sysparm_limit`  | integer | No       | —       | Maximum number of CIs to return                                                       |
| `sysparm_offset` | integer | No       | —       | Starting index for pagination                                                         |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "className": {
        "type": "string",
        "description": "CMDB class name (e.g., cmdb_ci_server, cmdb_ci_linux_server, cmdb_ci_database)"
      },
      "sysparm_query": {
        "type": "string",
        "description": "Encoded query to filter CIs"
      },
      "sysparm_limit": {
        "type": "integer",
        "description": "Maximum number of CIs to return"
      },
      "sysparm_offset": {
        "type": "integer",
        "description": "Starting index for pagination"
      }
    },
    "required": [
      "PCID",
      "className"
    ]
  }
  ```
</Expandable>

***

## servicenow\_cmdb\_update\_configuration\_item

Update a configuration item

**Parameters:**

| Parameter    | Type   | Required | Default | Description                                                                                 |
| ------------ | ------ | -------- | ------- | ------------------------------------------------------------------------------------------- |
| `className`  | string | Yes      | —       | CMDB class name of the CI                                                                   |
| `sys_id`     | string | Yes      | —       | sys\_id of the CI to update                                                                 |
| `attributes` | object | No       | —       | CI attributes to update (e.g., \{"ip\_address": "10.0.0.2", "os\_version": "Ubuntu 22.04"}) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "className": {
        "type": "string",
        "description": "CMDB class name of the CI"
      },
      "sys_id": {
        "type": "string",
        "description": "sys_id of the CI to update"
      },
      "attributes": {
        "type": "object",
        "description": "CI attributes to update (e.g., {\"ip_address\": \"10.0.0.2\", \"os_version\": \"Ubuntu 22.04\"})"
      }
    },
    "required": [
      "PCID",
      "className",
      "sys_id"
    ]
  }
  ```
</Expandable>