> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/navixy-graphql-api/business-data-repository/api-reference/devices.md).
# Devices
Complete reference for devices: register GPS trackers and sensors, manage hardware identifiers, link devices to assets, and track relations.
{% hint style="warning" %}
**Navixy GraphQL API is a work in progress.** This documentation is published for preview purposes only and doesn't reflect a stable release. Structure, field names, and behaviors are subject to change.
{% endhint %}
Devices are GPS trackers, sensors, and other hardware that collect and transmit location and telemetry data.
## Queries
### deviceTypes
Lists device types for a workspace.
```graphql
deviceTypes(
workspaceId: ID!
filter: CatalogItemFilter
first: Int
after: String
last: Int
before: String
orderBy: CatalogItemOrder = { field: ORDER, direction: ASC }
): DeviceTypeConnection!
```
**Arguments**
| Name | Type | Description |
| ------------- | ------------------- | --------------------------------------------------------------------------------------------- |
| `workspaceId` | `ID!` | The workspace to retrieve device types for. |
| `filter` | `CatalogItemFilter` | Filtering options for the returned device types. |
| `first` | `Int` | The first `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md). |
| `after` | `String` | The elements that come after the specified [cursor](/docs/navixy-graphql-api/pagination.md). |
| `last` | `Int` | The last `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md). |
| `before` | `String` | The elements that come before the specified [cursor](/docs/navixy-graphql-api/pagination.md). |
| `orderBy` | `CatalogItemOrder` | The ordering options for the returned device types. |
**Input types:**
CatalogItemFilter
Filtering options for catalog items.
| Field | Type | Description |
| --------------- | ---------------------------------------------------------------------- | --------------------------------------------------- |
| `titleContains` | `String` | Partial match on title (case-insensitive contains). |
| `codes` | \[[Code](/docs/navixy-graphql-api/core-api-reference/common.md#code)!] | Match any of these codes. |
CatalogItemOrder
Ordering options for catalog items.
| Field | Type | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| `field` | [CatalogItemOrderField](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemorderfield)! | The field to order by. |
| `direction` | [OrderDirection](/docs/navixy-graphql-api/core-api-reference/common.md#orderdirection)! | The direction to order. |
**Output types:**
DeviceTypeConnection
A paginated list of DeviceType items.
**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)
| Field | Type | Description |
| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges` | \[[DeviceTypeEdge](#devicetypeedge)!]! | A list of edges. |
| `nodes` | \[[DeviceType](#devicetype)!]! | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)! | Information about the current page. |
| `total` | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo) | The total count of items matching the filter. |
***
### deviceStatuses
Lists device statuses for a workspace.
```graphql
deviceStatuses(
workspaceId: ID!
filter: CatalogItemFilter
first: Int
after: String
last: Int
before: String
orderBy: CatalogItemOrder = { field: ORDER, direction: ASC }
): DeviceStatusConnection!
```
**Arguments**
| Name | Type | Description |
| ------------- | ------------------- | --------------------------------------------------------------------------------------------- |
| `workspaceId` | `ID!` | The workspace to retrieve device statuses for. |
| `filter` | `CatalogItemFilter` | Filtering options for the returned device statuses. |
| `first` | `Int` | The first `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md). |
| `after` | `String` | The elements that come after the specified [cursor](/docs/navixy-graphql-api/pagination.md). |
| `last` | `Int` | The last `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md). |
| `before` | `String` | The elements that come before the specified [cursor](/docs/navixy-graphql-api/pagination.md). |
| `orderBy` | `CatalogItemOrder` | The ordering options for the returned device statuses. |
**Input types:**
CatalogItemFilter
Filtering options for catalog items.
| Field | Type | Description |
| --------------- | ---------------------------------------------------------------------- | --------------------------------------------------- |
| `titleContains` | `String` | Partial match on title (case-insensitive contains). |
| `codes` | \[[Code](/docs/navixy-graphql-api/core-api-reference/common.md#code)!] | Match any of these codes. |
CatalogItemOrder
Ordering options for catalog items.
| Field | Type | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| `field` | [CatalogItemOrderField](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemorderfield)! | The field to order by. |
| `direction` | [OrderDirection](/docs/navixy-graphql-api/core-api-reference/common.md#orderdirection)! | The direction to order. |
**Output types:**
DeviceStatusConnection
A paginated list of DeviceStatus items.
**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)
| Field | Type | Description |
| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges` | \[[DeviceStatusEdge](#devicestatusedge)!]! | A list of edges. |
| `nodes` | \[[DeviceStatus](#devicestatus)!]! | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)! | Information about the current page. |
| `total` | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo) | The total count of items matching the filter. |
***
### deviceModels
Lists device models with optional vendor filter.
```graphql
deviceModels(
workspaceId: ID!
filter: DeviceModelFilter
first: Int
after: String
last: Int
before: String
orderBy: CatalogItemOrder = { field: TITLE, direction: ASC }
): DeviceModelConnection!
```
**Arguments**
| Name | Type | Description |
| ------------- | ------------------- | --------------------------------------------------------------------------------------------- |
| `workspaceId` | `ID!` | The workspace to retrieve device models for. |
| `filter` | `DeviceModelFilter` | Filtering options for the returned device models. |
| `first` | `Int` | The first `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md). |
| `after` | `String` | The elements that come after the specified [cursor](/docs/navixy-graphql-api/pagination.md). |
| `last` | `Int` | The last `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md). |
| `before` | `String` | The elements that come before the specified [cursor](/docs/navixy-graphql-api/pagination.md). |
| `orderBy` | `CatalogItemOrder` | The ordering options for the returned device models. |
**Input types:**
DeviceModelFilter
Filtering options for device models.
| Field | Type | Description |
| --------------- | ------------------------------------------------------------------ | --------------------------------------------------- |
| `vendorIds` | `[ID!]` | Filter by vendors (OR within field). |
| `titleContains` | `String` | Partial match on title (case-insensitive contains). |
| `code` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code) | Exact code match. |
CatalogItemOrder
Ordering options for catalog items.
| Field | Type | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| `field` | [CatalogItemOrderField](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemorderfield)! | The field to order by. |
| `direction` | [OrderDirection](/docs/navixy-graphql-api/core-api-reference/common.md#orderdirection)! | The direction to order. |
**Output types:**
DeviceModelConnection
A paginated list of DeviceModel items.
**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)
| Field | Type | Description |
| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges` | \[[DeviceModelEdge](#devicemodeledge)!]! | A list of edges. |
| `nodes` | \[[DeviceModel](#devicemodel)!]! | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)! | Information about the current page. |
| `total` | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo) | The total count of items matching the filter. |
***
### deviceVendors
Lists device vendors for a workspace.
```graphql
deviceVendors(
workspaceId: ID!
filter: CatalogItemFilter
first: Int
after: String
last: Int
before: String
orderBy: CatalogItemOrder = { field: ORDER, direction: ASC }
): DeviceVendorConnection!
```
**Arguments**
| Name | Type | Description |
| ------------- | ------------------- | --------------------------------------------------------------------------------------------- |
| `workspaceId` | `ID!` | The workspace to retrieve device vendors for. |
| `filter` | `CatalogItemFilter` | Filtering options for the returned device vendors. |
| `first` | `Int` | The first `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md). |
| `after` | `String` | The elements that come after the specified [cursor](/docs/navixy-graphql-api/pagination.md). |
| `last` | `Int` | The last `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md). |
| `before` | `String` | The elements that come before the specified [cursor](/docs/navixy-graphql-api/pagination.md). |
| `orderBy` | `CatalogItemOrder` | The ordering options for the returned device vendors. |
**Input types:**
CatalogItemFilter
Filtering options for catalog items.
| Field | Type | Description |
| --------------- | ---------------------------------------------------------------------- | --------------------------------------------------- |
| `titleContains` | `String` | Partial match on title (case-insensitive contains). |
| `codes` | \[[Code](/docs/navixy-graphql-api/core-api-reference/common.md#code)!] | Match any of these codes. |
CatalogItemOrder
Ordering options for catalog items.
| Field | Type | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| `field` | [CatalogItemOrderField](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemorderfield)! | The field to order by. |
| `direction` | [OrderDirection](/docs/navixy-graphql-api/core-api-reference/common.md#orderdirection)! | The direction to order. |
**Output types:**
DeviceVendorConnection
A paginated list of DeviceVendor items.
**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)
| Field | Type | Description |
| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges` | \[[DeviceVendorEdge](#devicevendoredge)!]! | A list of edges. |
| `nodes` | \[[DeviceVendor](#devicevendor)!]! | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)! | Information about the current page. |
| `total` | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo) | The total count of items matching the filter. |
***
### deviceRelationTypes
Lists device relation types for a workspace.
```graphql
deviceRelationTypes(
workspaceId: ID!
filter: CatalogItemFilter
first: Int
after: String
last: Int
before: String
orderBy: CatalogItemOrder = { field: ORDER, direction: ASC }
): DeviceRelationTypeConnection!
```
**Arguments**
| Name | Type | Description |
| ------------- | ------------------- | --------------------------------------------------------------------------------------------- |
| `workspaceId` | `ID!` | The workspace to retrieve device relation types for. |
| `filter` | `CatalogItemFilter` | Filtering options for the returned device relation types. |
| `first` | `Int` | The first `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md). |
| `after` | `String` | The elements that come after the specified [cursor](/docs/navixy-graphql-api/pagination.md). |
| `last` | `Int` | The last `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md). |
| `before` | `String` | The elements that come before the specified [cursor](/docs/navixy-graphql-api/pagination.md). |
| `orderBy` | `CatalogItemOrder` | The ordering options for the returned device relation types. |
**Input types:**
CatalogItemFilter
Filtering options for catalog items.
| Field | Type | Description |
| --------------- | ---------------------------------------------------------------------- | --------------------------------------------------- |
| `titleContains` | `String` | Partial match on title (case-insensitive contains). |
| `codes` | \[[Code](/docs/navixy-graphql-api/core-api-reference/common.md#code)!] | Match any of these codes. |
CatalogItemOrder
Ordering options for catalog items.
| Field | Type | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| `field` | [CatalogItemOrderField](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemorderfield)! | The field to order by. |
| `direction` | [OrderDirection](/docs/navixy-graphql-api/core-api-reference/common.md#orderdirection)! | The direction to order. |
**Output types:**
DeviceRelationTypeConnection
A paginated list of DeviceRelationType items.
**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)
| Field | Type | Description |
| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges` | \[[DeviceRelationTypeEdge](#devicerelationtypeedge)!]! | A list of edges. |
| `nodes` | \[[DeviceRelationType](#devicerelationtype)!]! | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)! | Information about the current page. |
| `total` | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo) | The total count of items matching the filter. |
***
### device (query)
Retrieves a device by its ID.
```graphql
device(id: ID!): Device
```
**Arguments**
| Name | Type | Description |
| ---- | ----- | --------------------------------- |
| `id` | `ID!` | The ID of the device to retrieve. |
**Output types:**
Device
A tracking device such as a GPS tracker, sensor, or beacon.
**Implements:** [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node), [Titled](/docs/navixy-graphql-api/core-api-reference/common.md#titled), [Versioned](/docs/navixy-graphql-api/core-api-reference/common.md#versioned), [InventoryItem](/docs/navixy-graphql-api/business-data-repository/api-reference/devices/inventory.md#inventoryitem)
| Field | Type | Description |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `ID!` | A globally unique identifier. This ID is opaque and should not be parsed by clients. |
| `version` | `Int!` | The version number for optimistic locking. Incremented on each update. Can be provided in update/delete mutations to prevent lost updates. If omitted, the update proceeds without stale-read protection. |
| `title` | `String!` | The human-readable display name. |
| `workspace` | [Workspace](/docs/navixy-graphql-api/business-data-repository/api-reference/workspaces.md#workspace)! | The workspace that owns this device. |
| `type` | [DeviceType](#devicetype)! | The device type classification. |
| `model` | [DeviceModel](#devicemodel)! | The specific device model. |
| `status` | [DeviceStatus](#devicestatus)! | The current operational status. |
| `identifiers` | \[[DeviceIdentifier](#deviceidentifier)!]! | The hardware identifiers for this device (IMEI, serial number, MAC address, etc.). |
| `asset` | [Asset](/docs/navixy-graphql-api/business-data-repository/api-reference/assets.md#asset) | The asset this device is currently linked to. |
| `inventory` | [Inventory](/docs/navixy-graphql-api/business-data-repository/api-reference/devices/inventory.md#inventory) | The inventory this device is currently assigned to. |
| `relationsFrom` | \[[DeviceRelation](#devicerelation)!]! | The outgoing relationships from this device to other devices. |
| `relationsTo` | \[[DeviceRelation](#devicerelation)!]! | The incoming relationships from other devices to this device. |
| `inventoryHistory` | [DeviceInventoryRelationConnection](/docs/navixy-graphql-api/business-data-repository/api-reference/devices/inventory.md#deviceinventoryrelationconnection)! | The history of inventory assignments for this device. |
***
### devices
Lists devices for a workspace.
```graphql
devices(
workspaceId: ID!
filter: DeviceFilter
first: Int
after: String
last: Int
before: String
orderBy: DeviceOrder = { field: TITLE, direction: ASC }
): DeviceConnection!
```
**Arguments**
| Name | Type | Description |
| ------------- | -------------- | --------------------------------------------------------------------------------------------- |
| `workspaceId` | `ID!` | The workspace to retrieve devices for. |
| `filter` | `DeviceFilter` | Filtering options for the returned devices. |
| `first` | `Int` | The first `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md). |
| `after` | `String` | The elements that come after the specified [cursor](/docs/navixy-graphql-api/pagination.md). |
| `last` | `Int` | The last `n` elements from the [paginated list](/docs/navixy-graphql-api/pagination.md). |
| `before` | `String` | The elements that come before the specified [cursor](/docs/navixy-graphql-api/pagination.md). |
| `orderBy` | `DeviceOrder` | The ordering options for the returned devices. |
**Input types:**
DeviceFilter
Filtering options for devices.
| Field | Type | Description |
| -------------------- | -------- | --------------------------------------------------------------------- |
| `typeIds` | `[ID!]` | Filter by device types (OR within field). |
| `modelIds` | `[ID!]` | Filter by device models (OR within field). |
| `statusIds` | `[ID!]` | Filter by statuses (OR within field). |
| `vendorIds` | `[ID!]` | Filter by vendors (OR within field). |
| `identifierContains` | `String` | Partial match on device identifier value (case-insensitive contains). |
| `inventoryIds` | `[ID!]` | Filter by inventories (OR within field). |
| `titleContains` | `String` | Partial match on title (case-insensitive contains). |
DeviceOrder
Ordering options for devices.
| Field | Type | Description |
| ----------- | --------------------------------------------------------------------------------------- | ----------------------- |
| `field` | [DeviceOrderField](#deviceorderfield) | The field to order by. |
| `direction` | [OrderDirection](/docs/navixy-graphql-api/core-api-reference/common.md#orderdirection)! | The direction to order. |
**Output types:**
DeviceConnection
A paginated list of Device items.
**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)
| Field | Type | Description |
| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges` | \[[DeviceEdge](#deviceedge)!]! | A list of edges. |
| `nodes` | \[[Device](#device)!]! | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)! | Information about the current page. |
| `total` | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo) | The total count of items matching the filter. |
***
## Mutations
### deviceCreate
Creates a new device.
```graphql
deviceCreate(
input: DeviceCreateInput!
): DevicePayload
```
**Arguments**
| Name | Type | Description |
| ------- | -------------------- | ----------------------------------------- |
| `input` | `DeviceCreateInput!` | The input fields for creating the device. |
**Input types:**
DeviceCreateInput
Input for creating a new device.
| Field | Type | Description |
| ------------- | --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `workspaceId` | `ID!` | The workspace that will own the device. |
| `typeId` | `ID!` | The device type ID. |
| `modelId` | `ID!` | The device model ID. |
| `title` | `String` | The device display name. If omitted or blank, the server generates "\ \ \" where the identifier is chosen by type priority: IMEI > SERIAL\_NUMBER > MAC\_ADDRESS, with fallback to identifiers\[0] when none of the priority types are present. With no identifiers at all the generated title is "\ \". |
| `identifiers` | \[[DeviceIdentifierInput](#deviceidentifierinput)!] | The hardware identifiers. Optional: a device may be registered before its hardware is known. Identifiers can be added later with `deviceIdentifierAdd`. |
| `inventoryId` | `ID` | Optionally assign the new device to an existing inventory. When provided, the inventory must belong to the same workspace; the assignment is atomic with device creation (the device is not created if the assignment fails). |
DeviceIdentifierInput
Input for a device identifier.
| Field | Type | Description |
| ----------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `type` | [DeviceIdType](#deviceidtype)! | The type of identifier. |
| `value` | `String!` | The identifier value. 1 to 64 Unicode code points, measured after `@trim` has removed leading and trailing whitespace. An astral character such as an emoji counts as one, though a UTF-16 `length` reports it as two. The limit is not expressible in the schema and is enforced by the server: a longer value is rejected with `VALIDATION_ERROR`. |
| `namespace` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code) | The namespace for uniqueness scope. Null means globally unique. |
**Output types:**
DevicePayload
The result of a device mutation.
| Field | Type | Description |
| -------- | ------------------ | ------------------------------ |
| `device` | [Device](#device)! | The created or updated device. |
Device (entity)
A tracking device such as a GPS tracker, sensor, or beacon.
**Implements:** [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node), [Titled](/docs/navixy-graphql-api/core-api-reference/common.md#titled), [Versioned](/docs/navixy-graphql-api/core-api-reference/common.md#versioned), [InventoryItem](/docs/navixy-graphql-api/business-data-repository/api-reference/devices/inventory.md#inventoryitem)
| Field | Type | Description |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `ID!` | A globally unique identifier. This ID is opaque and should not be parsed by clients. |
| `version` | `Int!` | The version number for optimistic locking. Incremented on each update. Can be provided in update/delete mutations to prevent lost updates. If omitted, the update proceeds without stale-read protection. |
| `title` | `String!` | The human-readable display name. |
| `workspace` | [Workspace](/docs/navixy-graphql-api/business-data-repository/api-reference/workspaces.md#workspace)! | The workspace that owns this device. |
| `type` | [DeviceType](#devicetype)! | The device type classification. |
| `model` | [DeviceModel](#devicemodel)! | The specific device model. |
| `status` | [DeviceStatus](#devicestatus)! | The current operational status. |
| `identifiers` | \[[DeviceIdentifier](#deviceidentifier)!]! | The hardware identifiers for this device (IMEI, serial number, MAC address, etc.). |
| `asset` | [Asset](/docs/navixy-graphql-api/business-data-repository/api-reference/assets.md#asset) | The asset this device is currently linked to. |
| `inventory` | [Inventory](/docs/navixy-graphql-api/business-data-repository/api-reference/devices/inventory.md#inventory) | The inventory this device is currently assigned to. |
| `relationsFrom` | \[[DeviceRelation](#devicerelation)!]! | The outgoing relationships from this device to other devices. |
| `relationsTo` | \[[DeviceRelation](#devicerelation)!]! | The incoming relationships from other devices to this device. |
| `inventoryHistory` | [DeviceInventoryRelationConnection](/docs/navixy-graphql-api/business-data-repository/api-reference/devices/inventory.md#deviceinventoryrelationconnection)! | The history of inventory assignments for this device. |
***
### deviceUpdate
Updates an existing device.
```graphql
deviceUpdate(
input: DeviceUpdateInput!
): DevicePayload
```
**Arguments**
| Name | Type | Description |
| ------- | -------------------- | ----------------------------------------- |
| `input` | `DeviceUpdateInput!` | The input fields for updating the device. |
**Input types:**
DeviceUpdateInput
Input for updating an existing device.
| Field | Type | Description |
| --------- | -------- | ----------------------------------------------------------------------------------------------- |
| `id` | `ID!` | The device ID to update. |
| `version` | `Int` | The current version for optimistic locking. If omitted, auto-increments without conflict check. |
| `modelId` | `ID` | The new device model. |
| `title` | `String` | The new display name. |
**Output types:**
DevicePayload
The result of a device mutation.
| Field | Type | Description |
| -------- | ------------------ | ------------------------------ |
| `device` | [Device](#device)! | The created or updated device. |
Device (entity)
A tracking device such as a GPS tracker, sensor, or beacon.
**Implements:** [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node), [Titled](/docs/navixy-graphql-api/core-api-reference/common.md#titled), [Versioned](/docs/navixy-graphql-api/core-api-reference/common.md#versioned), [InventoryItem](/docs/navixy-graphql-api/business-data-repository/api-reference/devices/inventory.md#inventoryitem)
| Field | Type | Description |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `ID!` | A globally unique identifier. This ID is opaque and should not be parsed by clients. |
| `version` | `Int!` | The version number for optimistic locking. Incremented on each update. Can be provided in update/delete mutations to prevent lost updates. If omitted, the update proceeds without stale-read protection. |
| `title` | `String!` | The human-readable display name. |
| `workspace` | [Workspace](/docs/navixy-graphql-api/business-data-repository/api-reference/workspaces.md#workspace)! | The workspace that owns this device. |
| `type` | [DeviceType](#devicetype)! | The device type classification. |
| `model` | [DeviceModel](#devicemodel)! | The specific device model. |
| `status` | [DeviceStatus](#devicestatus)! | The current operational status. |
| `identifiers` | \[[DeviceIdentifier](#deviceidentifier)!]! | The hardware identifiers for this device (IMEI, serial number, MAC address, etc.). |
| `asset` | [Asset](/docs/navixy-graphql-api/business-data-repository/api-reference/assets.md#asset) | The asset this device is currently linked to. |
| `inventory` | [Inventory](/docs/navixy-graphql-api/business-data-repository/api-reference/devices/inventory.md#inventory) | The inventory this device is currently assigned to. |
| `relationsFrom` | \[[DeviceRelation](#devicerelation)!]! | The outgoing relationships from this device to other devices. |
| `relationsTo` | \[[DeviceRelation](#devicerelation)!]! | The incoming relationships from other devices to this device. |
| `inventoryHistory` | [DeviceInventoryRelationConnection](/docs/navixy-graphql-api/business-data-repository/api-reference/devices/inventory.md#deviceinventoryrelationconnection)! | The history of inventory assignments for this device. |
***
### deviceDelete
Deletes a device.
Every `DEVICE` custom-field value pointing at it is detached in the same transaction, on assets and on geo objects alike, so no holder is left naming a device that is gone.
Rejected with `VALIDATION_ERROR` when one of those fields `isRequired`: detaching would leave that holder invalid. Nothing is detached in that case, and the message names the holder and the field code — a delete can therefore fail because of a field on an entirely different object.
```graphql
deviceDelete(
input: DeviceDeleteInput!
): DeletePayload
```
**Arguments**
| Name | Type | Description |
| ------- | -------------------- | ----------------------------------------- |
| `input` | `DeviceDeleteInput!` | The input fields for deleting the device. |
**Input types:**
DeviceDeleteInput
Input for deleting a device.
| Field | Type | Description |
| --------- | ----- | ----------------------------------------------------------------------------------------------- |
| `id` | `ID!` | The device ID to delete. |
| `version` | `Int` | The current version for optimistic locking. If omitted, auto-increments without conflict check. |
**Output types:**
DeletePayload
The result of a delete mutation.
| Field | Type | Description |
| ----------- | ----- | ----------------------------- |
| `deletedId` | `ID!` | The ID of the deleted entity. |
***
### deviceIdentifierAdd
Adds an identifier to a device.
Not an idempotent command: `DUPLICATE` when an identifier with the same `type`, `value` and `namespace` already exists — the uniqueness scope is the whole installation, not the device, so the conflict may sit on a device the caller cannot see. A `null` namespace is global and collides with other `null` namespaces.
```graphql
deviceIdentifierAdd(
input: DeviceIdentifierAddInput!
): DeviceIdentifierPayload
```
**Arguments**
| Name | Type | Description |
| ------- | --------------------------- | ------------------------------------------- |
| `input` | `DeviceIdentifierAddInput!` | The input fields for adding the identifier. |
**Input types:**
DeviceIdentifierAddInput
Input for adding an identifier to a device.
| Field | Type | Description |
| ------------ | ------------------------------------------------ | ----------------------- |
| `deviceId` | `ID!` | The device ID. |
| `identifier` | [DeviceIdentifierInput](#deviceidentifierinput)! | The identifier details. |
DeviceIdentifierInput
Input for a device identifier.
| Field | Type | Description |
| ----------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `type` | [DeviceIdType](#deviceidtype)! | The type of identifier. |
| `value` | `String!` | The identifier value. 1 to 64 Unicode code points, measured after `@trim` has removed leading and trailing whitespace. An astral character such as an emoji counts as one, though a UTF-16 `length` reports it as two. The limit is not expressible in the schema and is enforced by the server: a longer value is rejected with `VALIDATION_ERROR`. |
| `namespace` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code) | The namespace for uniqueness scope. Null means globally unique. |
**Output types:**
DeviceIdentifierPayload
The result of a device identifier mutation.
| Field | Type | Description |
| ------------------ | -------------------------------------- | ---------------------------- |
| `deviceIdentifier` | [DeviceIdentifier](#deviceidentifier)! | The added device identifier. |
DeviceIdentifier (entity)
A hardware identifier for a device.
**Implements:** [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node)
| Field | Type | Description |
| ----------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| `id` | `ID!` | A globally unique identifier. This ID is opaque and should not be parsed by clients. |
| `device` | [Device](#device)! | The device this identifier belongs to. |
| `type` | [DeviceIdType](#deviceidtype)! | The type of identifier. |
| `value` | `String!` | The identifier value. |
| `namespace` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code) | The namespace for uniqueness scope. Null means the identifier is globally unique. |
***
### deviceIdentifierRemove
Removes an identifier from a device.
Not an idempotent command: `NOT_FOUND` when `identifierId` names no identifier, including a repeat of a call that already succeeded.
```graphql
deviceIdentifierRemove(
input: DeviceIdentifierRemoveInput!
): DeletePayload
```
**Arguments**
| Name | Type | Description |
| ------- | ------------------------------ | --------------------------------------------- |
| `input` | `DeviceIdentifierRemoveInput!` | The input fields for removing the identifier. |
**Input types:**
DeviceIdentifierRemoveInput
Input for removing an identifier from a device.
| Field | Type | Description |
| -------------- | ----- | ---------------------------- |
| `identifierId` | `ID!` | The identifier ID to remove. |
**Output types:**
DeletePayload
The result of a delete mutation.
| Field | Type | Description |
| ----------- | ----- | ----------------------------- |
| `deletedId` | `ID!` | The ID of the deleted entity. |
***
### deviceRelationCreate
Creates a relationship between devices.
Not an idempotent command: `DUPLICATE` when the same `firstId`, `secondId` and `typeId` are already related. The pair is ordered — relating A to B does not relate B to A, and creating the reverse is a second, separate relationship rather than a duplicate.
```graphql
deviceRelationCreate(
input: DeviceRelationCreateInput!
): DeviceRelationPayload
```
**Arguments**
| Name | Type | Description |
| ------- | ---------------------------- | ----------------------------------------------- |
| `input` | `DeviceRelationCreateInput!` | The input fields for creating the relationship. |
**Input types:**
DeviceRelationCreateInput
Input for creating a relationship between devices.
| Field | Type | Description |
| ---------- | ----- | ------------------------- |
| `firstId` | `ID!` | The first device ID. |
| `secondId` | `ID!` | The second device ID. |
| `typeId` | `ID!` | The relationship type ID. |
**Output types:**
DeviceRelationPayload
The result of a device relation mutation.
| Field | Type | Description |
| ---------------- | ---------------------------------- | -------------------------------- |
| `deviceRelation` | [DeviceRelation](#devicerelation)! | The created device relationship. |
DeviceRelation (entity)
A relationship between two devices.
**Implements:** [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node)
| Field | Type | Description |
| -------- | ------------------------------------------ | ------------------------------------------------------------------------------------ |
| `id` | `ID!` | A globally unique identifier. This ID is opaque and should not be parsed by clients. |
| `first` | [Device](#device)! | The first device in the relationship. |
| `second` | [Device](#device)! | The second device in the relationship. |
| `type` | [DeviceRelationType](#devicerelationtype)! | The type of relationship. |
***
### deviceRelationRemove
Removes a device relationship.
Not an idempotent command: `NOT_FOUND` when `id` names no relationship, including a repeat of a call that already succeeded.
```graphql
deviceRelationRemove(
input: DeviceRelationRemoveInput!
): DeletePayload
```
**Arguments**
| Name | Type | Description |
| ------- | ---------------------------- | ----------------------------------------------- |
| `input` | `DeviceRelationRemoveInput!` | The input fields for removing the relationship. |
**Input types:**
DeviceRelationRemoveInput
Input for removing a device relationship.
| Field | Type | Description |
| ----- | ----- | ------------------------------ |
| `id` | `ID!` | The relationship ID to remove. |
**Output types:**
DeletePayload
The result of a delete mutation.
| Field | Type | Description |
| ----------- | ----- | ----------------------------- |
| `deletedId` | `ID!` | The ID of the deleted entity. |
***
### deviceTypeCreate
Creates a new device type.
```graphql
deviceTypeCreate(
input: DeviceTypeCreateInput!
): DeviceTypePayload
```
**Arguments**
| Name | Type | Description |
| ------- | ------------------------ | ---------------------------------------------- |
| `input` | `DeviceTypeCreateInput!` | The input fields for creating the device type. |
**Input types:**
DeviceTypeCreateInput
Input for creating a device type.
| Field | Type | Description |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| `workspaceId` | `ID!` | The workspace that will own the item. |
| `code` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code) | The machine-readable code. Auto-generated from title if omitted. |
| `title` | `String!` | The display name. |
| `order` | `Int` | The display order. Auto-calculated as last position if omitted. |
| `meta` | [CatalogItemMetaInput](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmetainput) | The display properties. |
CatalogItemMetaInput
Display properties for catalog items.
| Field | Type | Description |
| ------------- | --------- | ------------------------------------------------- |
| `description` | `String` | The description. |
| `hidden` | `Boolean` | Whether the item is hidden from regular UI lists. |
**Output types:**
DeviceTypePayload
The result of a device type mutation.
| Field | Type | Description |
| ------------ | -------------------------- | ----------------------------------- |
| `deviceType` | [DeviceType](#devicetype)! | The created or updated device type. |
DeviceType (entity)
A classification type for devices.
**Implements:** [CatalogItem](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitem), [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node), [Versioned](/docs/navixy-graphql-api/core-api-reference/common.md#versioned), [Titled](/docs/navixy-graphql-api/core-api-reference/common.md#titled)
| Field | Type | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `id` | `ID!` | A globally unique identifier. |
| `version` | `Int!` | The version number for optimistic locking. |
| `title` | `String!` | The human-readable display name. Can be localized. |
| `code` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code)! | A machine-readable code, unique within the catalog scope. |
| `order` | `Int!` | The display order within the same level or category. |
| `catalog` | [Catalog](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalog)! | The catalog this item belongs to. |
| `workspace` | [Workspace](/docs/navixy-graphql-api/business-data-repository/api-reference/workspaces.md#workspace) | The workspace that owns this item. Null for system items. |
| `meta` | [CatalogItemMeta](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmeta)! | Metadata about this item including description, origin, and display properties. |
***
### deviceTypeUpdate
Updates a device type.
```graphql
deviceTypeUpdate(
input: DeviceTypeUpdateInput!
): DeviceTypePayload
```
**Arguments**
| Name | Type | Description |
| ------- | ------------------------ | ---------------------------------------------- |
| `input` | `DeviceTypeUpdateInput!` | The input fields for updating the device type. |
**Input types:**
DeviceTypeUpdateInput
Input for updating a device type.
| Field | Type | Description |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `id` | `ID!` | The item ID to update. |
| `version` | `Int` | The current version for optimistic locking. If omitted, auto-increments without conflict check. |
| `title` | `String` | The new display name. |
| `order` | `Int` | The new display order. |
| `meta` | [CatalogItemMetaInput](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmetainput) | The display properties. |
CatalogItemMetaInput
Display properties for catalog items.
| Field | Type | Description |
| ------------- | --------- | ------------------------------------------------- |
| `description` | `String` | The description. |
| `hidden` | `Boolean` | Whether the item is hidden from regular UI lists. |
**Output types:**
DeviceTypePayload
The result of a device type mutation.
| Field | Type | Description |
| ------------ | -------------------------- | ----------------------------------- |
| `deviceType` | [DeviceType](#devicetype)! | The created or updated device type. |
DeviceType (entity)
A classification type for devices.
**Implements:** [CatalogItem](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitem), [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node), [Versioned](/docs/navixy-graphql-api/core-api-reference/common.md#versioned), [Titled](/docs/navixy-graphql-api/core-api-reference/common.md#titled)
| Field | Type | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `id` | `ID!` | A globally unique identifier. |
| `version` | `Int!` | The version number for optimistic locking. |
| `title` | `String!` | The human-readable display name. Can be localized. |
| `code` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code)! | A machine-readable code, unique within the catalog scope. |
| `order` | `Int!` | The display order within the same level or category. |
| `catalog` | [Catalog](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalog)! | The catalog this item belongs to. |
| `workspace` | [Workspace](/docs/navixy-graphql-api/business-data-repository/api-reference/workspaces.md#workspace) | The workspace that owns this item. Null for system items. |
| `meta` | [CatalogItemMeta](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmeta)! | Metadata about this item including description, origin, and display properties. |
***
### deviceTypeDelete
Deletes a device type.
```graphql
deviceTypeDelete(
input: CatalogItemDeleteInput!
): DeletePayload
```
**Arguments**
| Name | Type | Description |
| ------- | ------------------------- | ---------------------------------------------- |
| `input` | `CatalogItemDeleteInput!` | The input fields for deleting the device type. |
**Input types:**
CatalogItemDeleteInput
Input for deleting a catalog item.
| Field | Type | Description |
| --------- | ----- | ----------------------------------------------------------------------------------------------- |
| `id` | `ID!` | The catalog item ID to delete. |
| `version` | `Int` | The current version for optimistic locking. If omitted, auto-increments without conflict check. |
**Output types:**
DeletePayload
The result of a delete mutation.
| Field | Type | Description |
| ----------- | ----- | ----------------------------- |
| `deletedId` | `ID!` | The ID of the deleted entity. |
***
### deviceStatusCreate
Creates a new device status.
```graphql
deviceStatusCreate(
input: DeviceStatusCreateInput!
): DeviceStatusPayload
```
**Arguments**
| Name | Type | Description |
| ------- | -------------------------- | ------------------------------------------------ |
| `input` | `DeviceStatusCreateInput!` | The input fields for creating the device status. |
**Input types:**
DeviceStatusCreateInput
Input for creating a device status.
| Field | Type | Description |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| `workspaceId` | `ID!` | The workspace that will own the item. |
| `code` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code) | The machine-readable code. Auto-generated from title if omitted. |
| `title` | `String!` | The display name. |
| `order` | `Int` | The display order. Auto-calculated as last position if omitted. |
| `meta` | [CatalogItemMetaInput](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmetainput) | The display properties. |
CatalogItemMetaInput
Display properties for catalog items.
| Field | Type | Description |
| ------------- | --------- | ------------------------------------------------- |
| `description` | `String` | The description. |
| `hidden` | `Boolean` | Whether the item is hidden from regular UI lists. |
**Output types:**
DeviceStatusPayload
The result of a device status mutation.
| Field | Type | Description |
| -------------- | ------------------------------ | ------------------------------------- |
| `deviceStatus` | [DeviceStatus](#devicestatus)! | The created or updated device status. |
DeviceStatus (entity)
An operational status for devices.
**Implements:** [CatalogItem](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitem), [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node), [Versioned](/docs/navixy-graphql-api/core-api-reference/common.md#versioned), [Titled](/docs/navixy-graphql-api/core-api-reference/common.md#titled)
| Field | Type | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `id` | `ID!` | A globally unique identifier. |
| `version` | `Int!` | The version number for optimistic locking. |
| `title` | `String!` | The human-readable display name. Can be localized. |
| `code` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code)! | A machine-readable code, unique within the catalog scope. |
| `order` | `Int!` | The display order within the same level or category. |
| `catalog` | [Catalog](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalog)! | The catalog this item belongs to. |
| `workspace` | [Workspace](/docs/navixy-graphql-api/business-data-repository/api-reference/workspaces.md#workspace) | The workspace that owns this item. Null for system items. |
| `meta` | [CatalogItemMeta](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmeta)! | Metadata about this item including description, origin, and display properties. |
***
### deviceStatusUpdate
Updates a device status.
```graphql
deviceStatusUpdate(
input: DeviceStatusUpdateInput!
): DeviceStatusPayload
```
**Arguments**
| Name | Type | Description |
| ------- | -------------------------- | ------------------------------------------------ |
| `input` | `DeviceStatusUpdateInput!` | The input fields for updating the device status. |
**Input types:**
DeviceStatusUpdateInput
Input for updating a device status.
| Field | Type | Description |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `id` | `ID!` | The item ID to update. |
| `version` | `Int` | The current version for optimistic locking. If omitted, auto-increments without conflict check. |
| `title` | `String` | The new display name. |
| `order` | `Int` | The new display order. |
| `meta` | [CatalogItemMetaInput](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmetainput) | The display properties. |
CatalogItemMetaInput
Display properties for catalog items.
| Field | Type | Description |
| ------------- | --------- | ------------------------------------------------- |
| `description` | `String` | The description. |
| `hidden` | `Boolean` | Whether the item is hidden from regular UI lists. |
**Output types:**
DeviceStatusPayload
The result of a device status mutation.
| Field | Type | Description |
| -------------- | ------------------------------ | ------------------------------------- |
| `deviceStatus` | [DeviceStatus](#devicestatus)! | The created or updated device status. |
DeviceStatus (entity)
An operational status for devices.
**Implements:** [CatalogItem](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitem), [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node), [Versioned](/docs/navixy-graphql-api/core-api-reference/common.md#versioned), [Titled](/docs/navixy-graphql-api/core-api-reference/common.md#titled)
| Field | Type | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `id` | `ID!` | A globally unique identifier. |
| `version` | `Int!` | The version number for optimistic locking. |
| `title` | `String!` | The human-readable display name. Can be localized. |
| `code` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code)! | A machine-readable code, unique within the catalog scope. |
| `order` | `Int!` | The display order within the same level or category. |
| `catalog` | [Catalog](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalog)! | The catalog this item belongs to. |
| `workspace` | [Workspace](/docs/navixy-graphql-api/business-data-repository/api-reference/workspaces.md#workspace) | The workspace that owns this item. Null for system items. |
| `meta` | [CatalogItemMeta](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmeta)! | Metadata about this item including description, origin, and display properties. |
***
### deviceStatusDelete
Deletes a device status.
```graphql
deviceStatusDelete(
input: CatalogItemDeleteInput!
): DeletePayload
```
**Arguments**
| Name | Type | Description |
| ------- | ------------------------- | ------------------------------------------------ |
| `input` | `CatalogItemDeleteInput!` | The input fields for deleting the device status. |
**Input types:**
CatalogItemDeleteInput
Input for deleting a catalog item.
| Field | Type | Description |
| --------- | ----- | ----------------------------------------------------------------------------------------------- |
| `id` | `ID!` | The catalog item ID to delete. |
| `version` | `Int` | The current version for optimistic locking. If omitted, auto-increments without conflict check. |
**Output types:**
DeletePayload
The result of a delete mutation.
| Field | Type | Description |
| ----------- | ----- | ----------------------------- |
| `deletedId` | `ID!` | The ID of the deleted entity. |
***
## Objects
### DeviceVendor
A device manufacturer or vendor.
**Implements:** [CatalogItem](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitem), [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node), [Versioned](/docs/navixy-graphql-api/core-api-reference/common.md#versioned), [Titled](/docs/navixy-graphql-api/core-api-reference/common.md#titled)
| Field | Type | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `id` | `ID!` | A globally unique identifier. |
| `version` | `Int!` | The version number for optimistic locking. |
| `title` | `String!` | The human-readable display name. Can be localized. |
| `code` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code)! | A machine-readable code, unique within the catalog scope. |
| `order` | `Int!` | The display order within the same level or category. |
| `catalog` | [Catalog](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalog)! | The catalog this item belongs to. |
| `workspace` | [Workspace](/docs/navixy-graphql-api/business-data-repository/api-reference/workspaces.md#workspace) | The workspace that owns this item. Null for system items. |
| `meta` | [CatalogItemMeta](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmeta)! | Metadata about this item including description, origin, and display properties. |
| `models` | [DeviceModelConnection](#devicemodelconnection)! | Device models produced by this vendor. |
***
### DeviceModel
A specific device model produced by a vendor.
**Implements:** [CatalogItem](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitem), [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node), [Versioned](/docs/navixy-graphql-api/core-api-reference/common.md#versioned), [Titled](/docs/navixy-graphql-api/core-api-reference/common.md#titled)
| Field | Type | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `id` | `ID!` | A globally unique identifier. |
| `version` | `Int!` | The version number for optimistic locking. |
| `title` | `String!` | The human-readable display name. Can be localized. |
| `code` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code)! | A machine-readable code, unique within the catalog scope. |
| `order` | `Int!` | The display order within the same level or category. |
| `catalog` | [Catalog](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalog)! | The catalog this item belongs to. |
| `workspace` | [Workspace](/docs/navixy-graphql-api/business-data-repository/api-reference/workspaces.md#workspace) | The workspace that owns this item. Null for system items. |
| `meta` | [CatalogItemMeta](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmeta)! | Metadata about this item including description, origin, and display properties. |
| `vendor` | [DeviceVendor](#devicevendor)! | The vendor that manufactures this model. |
***
### DeviceType
A classification type for devices.
**Implements:** [CatalogItem](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitem), [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node), [Versioned](/docs/navixy-graphql-api/core-api-reference/common.md#versioned), [Titled](/docs/navixy-graphql-api/core-api-reference/common.md#titled)
| Field | Type | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `id` | `ID!` | A globally unique identifier. |
| `version` | `Int!` | The version number for optimistic locking. |
| `title` | `String!` | The human-readable display name. Can be localized. |
| `code` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code)! | A machine-readable code, unique within the catalog scope. |
| `order` | `Int!` | The display order within the same level or category. |
| `catalog` | [Catalog](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalog)! | The catalog this item belongs to. |
| `workspace` | [Workspace](/docs/navixy-graphql-api/business-data-repository/api-reference/workspaces.md#workspace) | The workspace that owns this item. Null for system items. |
| `meta` | [CatalogItemMeta](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmeta)! | Metadata about this item including description, origin, and display properties. |
***
### DeviceStatus
An operational status for devices.
**Implements:** [CatalogItem](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitem), [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node), [Versioned](/docs/navixy-graphql-api/core-api-reference/common.md#versioned), [Titled](/docs/navixy-graphql-api/core-api-reference/common.md#titled)
| Field | Type | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `id` | `ID!` | A globally unique identifier. |
| `version` | `Int!` | The version number for optimistic locking. |
| `title` | `String!` | The human-readable display name. Can be localized. |
| `code` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code)! | A machine-readable code, unique within the catalog scope. |
| `order` | `Int!` | The display order within the same level or category. |
| `catalog` | [Catalog](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalog)! | The catalog this item belongs to. |
| `workspace` | [Workspace](/docs/navixy-graphql-api/business-data-repository/api-reference/workspaces.md#workspace) | The workspace that owns this item. Null for system items. |
| `meta` | [CatalogItemMeta](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmeta)! | Metadata about this item including description, origin, and display properties. |
***
### DeviceRelationType
A type of relationship between two devices.
**Implements:** [CatalogItem](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitem), [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node), [Versioned](/docs/navixy-graphql-api/core-api-reference/common.md#versioned), [Titled](/docs/navixy-graphql-api/core-api-reference/common.md#titled)
| Field | Type | Description |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `id` | `ID!` | A globally unique identifier. |
| `version` | `Int!` | The version number for optimistic locking. |
| `title` | `String!` | The human-readable display name. Can be localized. |
| `code` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code)! | A machine-readable code, unique within the catalog scope. |
| `order` | `Int!` | The display order within the same level or category. |
| `catalog` | [Catalog](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalog)! | The catalog this item belongs to. |
| `workspace` | [Workspace](/docs/navixy-graphql-api/business-data-repository/api-reference/workspaces.md#workspace) | The workspace that owns this item. Null for system items. |
| `meta` | [CatalogItemMeta](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmeta)! | Metadata about this item including description, origin, and display properties. |
***
### Device
A tracking device such as a GPS tracker, sensor, or beacon.
**Implements:** [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node), [Titled](/docs/navixy-graphql-api/core-api-reference/common.md#titled), [Versioned](/docs/navixy-graphql-api/core-api-reference/common.md#versioned), [InventoryItem](/docs/navixy-graphql-api/business-data-repository/api-reference/devices/inventory.md#inventoryitem)
| Field | Type | Description |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `ID!` | A globally unique identifier. This ID is opaque and should not be parsed by clients. |
| `version` | `Int!` | The version number for optimistic locking. Incremented on each update. Can be provided in update/delete mutations to prevent lost updates. If omitted, the update proceeds without stale-read protection. |
| `title` | `String!` | The human-readable display name. |
| `workspace` | [Workspace](/docs/navixy-graphql-api/business-data-repository/api-reference/workspaces.md#workspace)! | The workspace that owns this device. |
| `type` | [DeviceType](#devicetype)! | The device type classification. |
| `model` | [DeviceModel](#devicemodel)! | The specific device model. |
| `status` | [DeviceStatus](#devicestatus)! | The current operational status. |
| `identifiers` | \[[DeviceIdentifier](#deviceidentifier)!]! | The hardware identifiers for this device (IMEI, serial number, MAC address, etc.). |
| `asset` | [Asset](/docs/navixy-graphql-api/business-data-repository/api-reference/assets.md#asset) | The asset this device is currently linked to. |
| `inventory` | [Inventory](/docs/navixy-graphql-api/business-data-repository/api-reference/devices/inventory.md#inventory) | The inventory this device is currently assigned to. |
| `relationsFrom` | \[[DeviceRelation](#devicerelation)!]! | The outgoing relationships from this device to other devices. |
| `relationsTo` | \[[DeviceRelation](#devicerelation)!]! | The incoming relationships from other devices to this device. |
| `inventoryHistory` | [DeviceInventoryRelationConnection](/docs/navixy-graphql-api/business-data-repository/api-reference/devices/inventory.md#deviceinventoryrelationconnection)! | The history of inventory assignments for this device. |
***
### DeviceIdentifier
A hardware identifier for a device.
**Implements:** [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node)
| Field | Type | Description |
| ----------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| `id` | `ID!` | A globally unique identifier. This ID is opaque and should not be parsed by clients. |
| `device` | [Device](#device)! | The device this identifier belongs to. |
| `type` | [DeviceIdType](#deviceidtype)! | The type of identifier. |
| `value` | `String!` | The identifier value. |
| `namespace` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code) | The namespace for uniqueness scope. Null means the identifier is globally unique. |
***
### DeviceRelation
A relationship between two devices.
**Implements:** [Node](/docs/navixy-graphql-api/core-api-reference/common.md#node)
| Field | Type | Description |
| -------- | ------------------------------------------ | ------------------------------------------------------------------------------------ |
| `id` | `ID!` | A globally unique identifier. This ID is opaque and should not be parsed by clients. |
| `first` | [Device](#device)! | The first device in the relationship. |
| `second` | [Device](#device)! | The second device in the relationship. |
| `type` | [DeviceRelationType](#devicerelationtype)! | The type of relationship. |
***
### DevicePayload
The result of a device mutation.
| Field | Type | Description |
| -------- | ------------------ | ------------------------------ |
| `device` | [Device](#device)! | The created or updated device. |
***
### DeviceIdentifierPayload
The result of a device identifier mutation.
| Field | Type | Description |
| ------------------ | -------------------------------------- | ---------------------------- |
| `deviceIdentifier` | [DeviceIdentifier](#deviceidentifier)! | The added device identifier. |
***
### DeviceRelationPayload
The result of a device relation mutation.
| Field | Type | Description |
| ---------------- | ---------------------------------- | -------------------------------- |
| `deviceRelation` | [DeviceRelation](#devicerelation)! | The created device relationship. |
***
### DeviceTypePayload
The result of a device type mutation.
| Field | Type | Description |
| ------------ | -------------------------- | ----------------------------------- |
| `deviceType` | [DeviceType](#devicetype)! | The created or updated device type. |
***
### DeviceStatusPayload
The result of a device status mutation.
| Field | Type | Description |
| -------------- | ------------------------------ | ------------------------------------- |
| `deviceStatus` | [DeviceStatus](#devicestatus)! | The created or updated device status. |
***
## Inputs
### DeviceFilter
Filtering options for devices.
| Field | Type | Description |
| -------------------- | -------- | --------------------------------------------------------------------- |
| `typeIds` | `[ID!]` | Filter by device types (OR within field). |
| `modelIds` | `[ID!]` | Filter by device models (OR within field). |
| `statusIds` | `[ID!]` | Filter by statuses (OR within field). |
| `vendorIds` | `[ID!]` | Filter by vendors (OR within field). |
| `identifierContains` | `String` | Partial match on device identifier value (case-insensitive contains). |
| `inventoryIds` | `[ID!]` | Filter by inventories (OR within field). |
| `titleContains` | `String` | Partial match on title (case-insensitive contains). |
***
### DeviceOrder
Ordering options for devices.
| Field | Type | Description |
| ----------- | --------------------------------------------------------------------------------------- | ----------------------- |
| `field` | [DeviceOrderField](#deviceorderfield) | The field to order by. |
| `direction` | [OrderDirection](/docs/navixy-graphql-api/core-api-reference/common.md#orderdirection)! | The direction to order. |
***
### DeviceModelFilter
Filtering options for device models.
| Field | Type | Description |
| --------------- | ------------------------------------------------------------------ | --------------------------------------------------- |
| `vendorIds` | `[ID!]` | Filter by vendors (OR within field). |
| `titleContains` | `String` | Partial match on title (case-insensitive contains). |
| `code` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code) | Exact code match. |
***
### DeviceCreateInput
Input for creating a new device.
| Field | Type | Description |
| ------------- | --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `workspaceId` | `ID!` | The workspace that will own the device. |
| `typeId` | `ID!` | The device type ID. |
| `modelId` | `ID!` | The device model ID. |
| `title` | `String` | The device display name. If omitted or blank, the server generates "\ \ \" where the identifier is chosen by type priority: IMEI > SERIAL\_NUMBER > MAC\_ADDRESS, with fallback to identifiers\[0] when none of the priority types are present. With no identifiers at all the generated title is "\ \". |
| `identifiers` | \[[DeviceIdentifierInput](#deviceidentifierinput)!] | The hardware identifiers. Optional: a device may be registered before its hardware is known. Identifiers can be added later with `deviceIdentifierAdd`. |
| `inventoryId` | `ID` | Optionally assign the new device to an existing inventory. When provided, the inventory must belong to the same workspace; the assignment is atomic with device creation (the device is not created if the assignment fails). |
***
### DeviceUpdateInput
Input for updating an existing device.
| Field | Type | Description |
| --------- | -------- | ----------------------------------------------------------------------------------------------- |
| `id` | `ID!` | The device ID to update. |
| `version` | `Int` | The current version for optimistic locking. If omitted, auto-increments without conflict check. |
| `modelId` | `ID` | The new device model. |
| `title` | `String` | The new display name. |
***
### DeviceDeleteInput
Input for deleting a device.
| Field | Type | Description |
| --------- | ----- | ----------------------------------------------------------------------------------------------- |
| `id` | `ID!` | The device ID to delete. |
| `version` | `Int` | The current version for optimistic locking. If omitted, auto-increments without conflict check. |
***
### DeviceIdentifierInput
Input for a device identifier.
| Field | Type | Description |
| ----------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `type` | [DeviceIdType](#deviceidtype)! | The type of identifier. |
| `value` | `String!` | The identifier value. 1 to 64 Unicode code points, measured after `@trim` has removed leading and trailing whitespace. An astral character such as an emoji counts as one, though a UTF-16 `length` reports it as two. The limit is not expressible in the schema and is enforced by the server: a longer value is rejected with `VALIDATION_ERROR`. |
| `namespace` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code) | The namespace for uniqueness scope. Null means globally unique. |
***
### DeviceIdentifierAddInput
Input for adding an identifier to a device.
| Field | Type | Description |
| ------------ | ------------------------------------------------ | ----------------------- |
| `deviceId` | `ID!` | The device ID. |
| `identifier` | [DeviceIdentifierInput](#deviceidentifierinput)! | The identifier details. |
***
### DeviceIdentifierRemoveInput
Input for removing an identifier from a device.
| Field | Type | Description |
| -------------- | ----- | ---------------------------- |
| `identifierId` | `ID!` | The identifier ID to remove. |
***
### DeviceRelationCreateInput
Input for creating a relationship between devices.
| Field | Type | Description |
| ---------- | ----- | ------------------------- |
| `firstId` | `ID!` | The first device ID. |
| `secondId` | `ID!` | The second device ID. |
| `typeId` | `ID!` | The relationship type ID. |
***
### DeviceRelationRemoveInput
Input for removing a device relationship.
| Field | Type | Description |
| ----- | ----- | ------------------------------ |
| `id` | `ID!` | The relationship ID to remove. |
***
### DeviceTypeCreateInput
Input for creating a device type.
| Field | Type | Description |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| `workspaceId` | `ID!` | The workspace that will own the item. |
| `code` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code) | The machine-readable code. Auto-generated from title if omitted. |
| `title` | `String!` | The display name. |
| `order` | `Int` | The display order. Auto-calculated as last position if omitted. |
| `meta` | [CatalogItemMetaInput](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmetainput) | The display properties. |
***
### DeviceTypeUpdateInput
Input for updating a device type.
| Field | Type | Description |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `id` | `ID!` | The item ID to update. |
| `version` | `Int` | The current version for optimistic locking. If omitted, auto-increments without conflict check. |
| `title` | `String` | The new display name. |
| `order` | `Int` | The new display order. |
| `meta` | [CatalogItemMetaInput](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmetainput) | The display properties. |
***
### DeviceStatusCreateInput
Input for creating a device status.
| Field | Type | Description |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| `workspaceId` | `ID!` | The workspace that will own the item. |
| `code` | [Code](/docs/navixy-graphql-api/core-api-reference/common.md#code) | The machine-readable code. Auto-generated from title if omitted. |
| `title` | `String!` | The display name. |
| `order` | `Int` | The display order. Auto-calculated as last position if omitted. |
| `meta` | [CatalogItemMetaInput](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmetainput) | The display properties. |
***
### DeviceStatusUpdateInput
Input for updating a device status.
| Field | Type | Description |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `id` | `ID!` | The item ID to update. |
| `version` | `Int` | The current version for optimistic locking. If omitted, auto-increments without conflict check. |
| `title` | `String` | The new display name. |
| `order` | `Int` | The new display order. |
| `meta` | [CatalogItemMetaInput](/docs/navixy-graphql-api/business-data-repository/api-reference/catalogs/catalog-items.md#catalogitemmetainput) | The display properties. |
***
## Enums
### DeviceIdType
The type of hardware identifier used to identify a device.
| Value | Description |
| --------------- | ----------------------------------------------------------- |
| `GUID` | A GUID/UUID identifier. |
| `IMEI` | International Mobile Equipment Identity. A 15-digit number. |
| `MEID_HEX` | Mobile Equipment Identifier in hexadecimal format. |
| `MEID_DEC` | Mobile Equipment Identifier in decimal format. |
| `MAC_ADDRESS` | Media Access Control address of a network interface. |
| `SERIAL_NUMBER` | Manufacturer-assigned serial number. |
| `CUSTOM` | A custom identifier type defined by the workspace. |
***
### DeviceOrderField
Fields available for ordering devices.
| Value | Description |
| ------- | --------------- |
| `TITLE` | Order by title. |
***
## Pagination types
### DeviceConnection
A paginated list of Device items.
**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)
| Field | Type | Description |
| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges` | \[[DeviceEdge](#deviceedge)!]! | A list of edges. |
| `nodes` | \[[Device](#device)!]! | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)! | Information about the current page. |
| `total` | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo) | The total count of items matching the filter. |
***
### DeviceEdge
An edge in the Device connection.
**Implements:** [Edge](/docs/navixy-graphql-api/core-api-reference/common.md#edge)
| Field | Type | Description |
| -------- | ------------------ | ---------------------------------- |
| `cursor` | `String!` | An opaque cursor for this edge. |
| `node` | [Device](#device)! | The device at the end of the edge. |
***
### DeviceTypeConnection
A paginated list of DeviceType items.
**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)
| Field | Type | Description |
| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges` | \[[DeviceTypeEdge](#devicetypeedge)!]! | A list of edges. |
| `nodes` | \[[DeviceType](#devicetype)!]! | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)! | Information about the current page. |
| `total` | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo) | The total count of items matching the filter. |
***
### DeviceTypeEdge
An edge in the DeviceType connection.
**Implements:** [Edge](/docs/navixy-graphql-api/core-api-reference/common.md#edge)
| Field | Type | Description |
| -------- | -------------------------- | --------------------------------------- |
| `cursor` | `String!` | An opaque cursor for this edge. |
| `node` | [DeviceType](#devicetype)! | The device type at the end of the edge. |
***
### DeviceStatusConnection
A paginated list of DeviceStatus items.
**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)
| Field | Type | Description |
| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges` | \[[DeviceStatusEdge](#devicestatusedge)!]! | A list of edges. |
| `nodes` | \[[DeviceStatus](#devicestatus)!]! | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)! | Information about the current page. |
| `total` | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo) | The total count of items matching the filter. |
***
### DeviceStatusEdge
An edge in the DeviceStatus connection.
**Implements:** [Edge](/docs/navixy-graphql-api/core-api-reference/common.md#edge)
| Field | Type | Description |
| -------- | ------------------------------ | ----------------------------------------- |
| `cursor` | `String!` | An opaque cursor for this edge. |
| `node` | [DeviceStatus](#devicestatus)! | The device status at the end of the edge. |
***
### DeviceModelConnection
A paginated list of DeviceModel items.
**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)
| Field | Type | Description |
| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges` | \[[DeviceModelEdge](#devicemodeledge)!]! | A list of edges. |
| `nodes` | \[[DeviceModel](#devicemodel)!]! | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)! | Information about the current page. |
| `total` | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo) | The total count of items matching the filter. |
***
### DeviceModelEdge
An edge in the DeviceModel connection.
**Implements:** [Edge](/docs/navixy-graphql-api/core-api-reference/common.md#edge)
| Field | Type | Description |
| -------- | ---------------------------- | ---------------------------------------- |
| `cursor` | `String!` | An opaque cursor for this edge. |
| `node` | [DeviceModel](#devicemodel)! | The device model at the end of the edge. |
***
### DeviceVendorConnection
A paginated list of DeviceVendor items.
**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)
| Field | Type | Description |
| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges` | \[[DeviceVendorEdge](#devicevendoredge)!]! | A list of edges. |
| `nodes` | \[[DeviceVendor](#devicevendor)!]! | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)! | Information about the current page. |
| `total` | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo) | The total count of items matching the filter. |
***
### DeviceVendorEdge
An edge in the DeviceVendor connection.
**Implements:** [Edge](/docs/navixy-graphql-api/core-api-reference/common.md#edge)
| Field | Type | Description |
| -------- | ------------------------------ | ----------------------------------------- |
| `cursor` | `String!` | An opaque cursor for this edge. |
| `node` | [DeviceVendor](#devicevendor)! | The device vendor at the end of the edge. |
***
### DeviceRelationTypeConnection
A paginated list of DeviceRelationType items.
**Implements:** [Connection](/docs/navixy-graphql-api/core-api-reference/common.md#connection)
| Field | Type | Description |
| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `edges` | \[[DeviceRelationTypeEdge](#devicerelationtypeedge)!]! | A list of edges. |
| `nodes` | \[[DeviceRelationType](#devicerelationtype)!]! | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-graphql-api/core-api-reference/common.md#pageinfo)! | Information about the current page. |
| `total` | [CountInfo](/docs/navixy-graphql-api/core-api-reference/common.md#countinfo) | The total count of items matching the filter. |
***
### DeviceRelationTypeEdge
An edge in the DeviceRelationType connection.
**Implements:** [Edge](/docs/navixy-graphql-api/core-api-reference/common.md#edge)
| Field | Type | Description |
| -------- | ------------------------------------------ | ------------------------------------------------ |
| `cursor` | `String!` | An opaque cursor for this edge. |
| `node` | [DeviceRelationType](#devicerelationtype)! | The device relation type at the end of the edge. |
***
## See also
* [Pagination](/docs/navixy-graphql-api/pagination.md)
* [Filtering and sorting](/docs/navixy-graphql-api/filtering-and-sorting.md)
* [Error handling](/docs/navixy-graphql-api/error-handling.md)
* [Optimistic locking](/docs/navixy-graphql-api/optimistic-locking.md)
* [Limits](/docs/navixy-graphql-api/limits.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://navixy.com/docs/navixy-graphql-api/business-data-repository/api-reference/devices.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.