DemandFlow Support Centre

CMDBREL: CI Relationship

Junction entity representing a dependency or relationship between two Configuration Items in the CMDB.

Default definition. This article describes the default CMDBREL definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches CMDBREL.

Entity properties

Property	Value
Entity code	`CMDBREL`
Display name	CI Relationship
Plural	CI Relationships
Level	51300

Use cases

CMDBREL is a junction entity for CI-to-CI relationships, similar to ITASSIGNMENT for asset assignments. Not shown in the menu - records are managed from the CMDB Dependencies panel. sourceCi is the CI that depends on targetCi. The relationshipType field classifies the nature of the dependency. CMDB shows two relatedlists: Depends On (stockRecord on sourceCi) and Depended On By (stockRecord on targetCi).

Fields

Relationship

Field	Type	Required	Notes
`sourceCi`	reference → `CMDB`	Yes	Source CI.
`relationshipType`	enum	Yes	Relationship Type. Valid ids: `1` (Depends On), `2` (Runs On), `3` (Hosted By), `4` (Connected To), `5` (Feeds Data To), `6` (Managed By), `7` (Backed Up By), `8` (Clustered With).
`targetCi`	reference → `CMDB`	Yes	Target CI.

Relationship: Details

Field	Type	Required	Notes
`description`	text (multi-line)		Description.
`criticality`	enum		Criticality. Valid ids: `1` (Critical), `2` (High), `3` (Medium), `4` (Low).
`status`	enum	Yes	Status. Valid ids: `1` (Active), `2` (Inactive).

Relationship: Audit

Field	Type	Required	Notes
`created`	datetime		Read-only. Created.
`createdBy`	reference → user		Read-only. Created By.

Relationships

Lookups: sourceCi points at a CMDB record; targetCi points at a CMDB record.

Creating a CI Relationship via the API

POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json

{
  "entity":   "CMDBREL",
  "level":    51300,
  "comboKey": "SUB:<your-sub-id>|ENT:",
  "sourceCi": "",
  "relationshipType": "1",
  "targetCi": "",
  "description": "Description"
}

Listing CI Relationships records

GET /v1/entities/CMDBREL/SUB

DemandFlow Support Centre

CMDBREL: CI Relationship

CMDBREL: CI Relationship

Entity properties

Use cases

Fields

Relationships

Creating a CI Relationship via the API

Listing CI Relationships records

See also

Was this article helpful?