# Inventory

{% hint style="warning" %}
**Navixy Repository 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 %}

Inventory management for device stock, including warehouses, assignments, and device-inventory relationships.

## Queries

### inventory

Retrieves an inventory by its ID.

```graphql
inventory(id: ID!): Inventory
```

**Arguments**

| Name | Type  | Description                          |
| ---- | ----- | ------------------------------------ |
| `id` | `ID!` | The ID of the inventory to retrieve. |

**Output types:**

<details>

<summary>Inventory</summary>

An inventory or warehouse record for device stock management.

**Implements:** [Node](/docs/navixy-repository-api/core-api-reference/common.md#type-node), [Versioned](/docs/navixy-repository-api/core-api-reference/common.md#type-versioned), [Titled](/docs/navixy-repository-api/core-api-reference/common.md#type-titled)

| 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.                                                                                                                                                                          |
| `organization` | [Organization](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organization)!         | The organization that owns this inventory.                                                                                                                                                                |
| `devices`      | [DeviceConnection](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-deviceconnection)! | The devices assigned to this inventory.                                                                                                                                                                   |

</details>

<details>

<summary>Organization (entity)</summary>

An organization in the hierarchy that owns entities and users.

**Implements:** [Node](/docs/navixy-repository-api/core-api-reference/common.md#type-node), [Versioned](/docs/navixy-repository-api/core-api-reference/common.md#type-versioned), [Titled](/docs/navixy-repository-api/core-api-reference/common.md#type-titled)

| 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.                                                                                                                                                                          |
| `externalId` | `String`                                                                                                               | An external system identifier for integration purposes.                                                                                                                                                   |
| `isActive`   | `Boolean!`                                                                                                             | Whether this organization is active.                                                                                                                                                                      |
| `features`   | \[[OrganizationFeature](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organizationfeature)!]!   | The feature flags enabled for this organization.                                                                                                                                                          |
| `parent`     | [Organization](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organization)                      | The parent organization in the hierarchy. Null for root organizations.                                                                                                                                    |
| `children`   | [OrganizationConnection](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organizationconnection)! | The child organizations.                                                                                                                                                                                  |
| `members`    | [MemberConnection](/docs/navixy-repository-api/core-api-reference/organizations/members.md#type-memberconnection)!     | The members of this organization.                                                                                                                                                                         |
| `devices`    | [DeviceConnection](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-deviceconnection)!             | The devices owned by this organization.                                                                                                                                                                   |
| `assets`     | [AssetConnection](/docs/navixy-repository-api/core-api-reference/assets/types.md#type-assetconnection)!                | The assets owned by this organization.                                                                                                                                                                    |
| `geoObjects` | [GeoObjectConnection](/docs/navixy-repository-api/core-api-reference/geo-objects/types.md#type-geoobjectconnection)!   | The geographic objects owned by this organization.                                                                                                                                                        |
| `schedules`  | [ScheduleConnection](/docs/navixy-repository-api/core-api-reference/schedules.md#type-scheduleconnection)!             | The schedules owned by this organization.                                                                                                                                                                 |

</details>

***

### inventories

Lists inventories for an organization.

```graphql
inventories(
    organizationId: ID!
    filter: InventoryFilter
    first: Int
    after: String
    last: Int
    before: String
    orderBy: InventoryOrder = { field: TITLE, direction: ASC }
  ): InventoryConnection!
```

**Arguments**

| Name             | Type              | Description                                                                                      |
| ---------------- | ----------------- | ------------------------------------------------------------------------------------------------ |
| `organizationId` | `ID!`             | The organization to retrieve inventories for.                                                    |
| `filter`         | `InventoryFilter` | Filtering options for the returned inventories.                                                  |
| `first`          | `Int`             | The first `n` elements from the [paginated list](/docs/navixy-repository-api/pagination.md).     |
| `after`          | `String`          | The elements that come after the specified [cursor](/docs/navixy-repository-api/pagination.md).  |
| `last`           | `Int`             | The last `n` elements from the [paginated list](/docs/navixy-repository-api/pagination.md).      |
| `before`         | `String`          | The elements that come before the specified [cursor](/docs/navixy-repository-api/pagination.md). |
| `orderBy`        | `InventoryOrder`  | The ordering options for the returned inventories.                                               |

**Input types:**

<details>

<summary>InventoryFilter</summary>

Filtering options for inventories.

| Field           | Type     | Description                                         |
| --------------- | -------- | --------------------------------------------------- |
| `titleContains` | `String` | Partial match on title (case-insensitive contains). |

</details>

<details>

<summary>InventoryOrder</summary>

Ordering options for inventories.

| Field       | Type                                                                                            | Description             |
| ----------- | ----------------------------------------------------------------------------------------------- | ----------------------- |
| `field`     | [InventoryOrderField](#type-inventoryorderfield)!                                               | The field to order by.  |
| `direction` | [OrderDirection](/docs/navixy-repository-api/core-api-reference/common.md#type-orderdirection)! | The direction to order. |

</details>

**Output types:**

<details>

<summary>InventoryConnection</summary>

A paginated list of Inventory items.

**Implements:** [Connection](/docs/navixy-repository-api/core-api-reference/common.md#type-connection)

| Field      | Type                                                                                 | Description                                                |
| ---------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------- |
| `edges`    | \[[InventoryEdge](#type-inventoryedge)!]!                                            | A list of edges.                                           |
| `nodes`    | \[[Inventory](#type-inventory)!]!                                                    | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-pageinfo)!  | Information about the current page.                        |
| `total`    | [CountInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-countinfo) | The total count of items matching the filter.              |

</details>

<details>

<summary>PageInfo (entity)</summary>

Information about the current page in a paginated connection.

| Field             | Type       | Description                                                |
| ----------------- | ---------- | ---------------------------------------------------------- |
| `hasNextPage`     | `Boolean!` | Whether more items exist after the current page.           |
| `hasPreviousPage` | `Boolean!` | Whether more items exist before the current page.          |
| `startCursor`     | `String`   | The cursor pointing to the first item in the current page. |
| `endCursor`       | `String`   | The cursor pointing to the last item in the current page.  |

</details>

***

## Mutations

### inventoryCreate

Creates a new inventory.

```graphql
inventoryCreate(
    input: InventoryCreateInput!
  ): InventoryPayload
```

**Arguments**

| Name    | Type                    | Description                                  |
| ------- | ----------------------- | -------------------------------------------- |
| `input` | `InventoryCreateInput!` | The input fields for creating the inventory. |

**Input types:**

<details>

<summary>InventoryCreateInput</summary>

Input for creating a new inventory.

| Field            | Type      | Description                                   |
| ---------------- | --------- | --------------------------------------------- |
| `organizationId` | `ID!`     | The organization that will own the inventory. |
| `title`          | `String!` | The display name.                             |

</details>

**Output types:**

<details>

<summary>InventoryPayload</summary>

The result of an inventory mutation.

| Field       | Type                          | Description                       |
| ----------- | ----------------------------- | --------------------------------- |
| `inventory` | [Inventory](#type-inventory)! | The created or updated inventory. |

</details>

<details>

<summary>Inventory (entity)</summary>

An inventory or warehouse record for device stock management.

**Implements:** [Node](/docs/navixy-repository-api/core-api-reference/common.md#type-node), [Versioned](/docs/navixy-repository-api/core-api-reference/common.md#type-versioned), [Titled](/docs/navixy-repository-api/core-api-reference/common.md#type-titled)

| 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.                                                                                                                                                                          |
| `organization` | [Organization](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organization)!         | The organization that owns this inventory.                                                                                                                                                                |
| `devices`      | [DeviceConnection](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-deviceconnection)! | The devices assigned to this inventory.                                                                                                                                                                   |

</details>

***

### inventoryUpdate

Updates an existing inventory.

```graphql
inventoryUpdate(
    input: InventoryUpdateInput!
  ): InventoryPayload
```

**Arguments**

| Name    | Type                    | Description                                  |
| ------- | ----------------------- | -------------------------------------------- |
| `input` | `InventoryUpdateInput!` | The input fields for updating the inventory. |

**Input types:**

<details>

<summary>InventoryUpdateInput</summary>

Input for updating an existing inventory.

| Field     | Type     | Description                                                                                     |
| --------- | -------- | ----------------------------------------------------------------------------------------------- |
| `id`      | `ID!`    | The inventory ID to update.                                                                     |
| `version` | `Int`    | The current version for optimistic locking. If omitted, auto-increments without conflict check. |
| `title`   | `String` | The new display name.                                                                           |

</details>

**Output types:**

<details>

<summary>InventoryPayload</summary>

The result of an inventory mutation.

| Field       | Type                          | Description                       |
| ----------- | ----------------------------- | --------------------------------- |
| `inventory` | [Inventory](#type-inventory)! | The created or updated inventory. |

</details>

<details>

<summary>Inventory (entity)</summary>

An inventory or warehouse record for device stock management.

**Implements:** [Node](/docs/navixy-repository-api/core-api-reference/common.md#type-node), [Versioned](/docs/navixy-repository-api/core-api-reference/common.md#type-versioned), [Titled](/docs/navixy-repository-api/core-api-reference/common.md#type-titled)

| 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.                                                                                                                                                                          |
| `organization` | [Organization](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organization)!         | The organization that owns this inventory.                                                                                                                                                                |
| `devices`      | [DeviceConnection](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-deviceconnection)! | The devices assigned to this inventory.                                                                                                                                                                   |

</details>

***

### inventoryDelete

Deletes an inventory.

```graphql
inventoryDelete(
    input: InventoryDeleteInput!
  ): DeletePayload
```

**Arguments**

| Name    | Type                    | Description                                  |
| ------- | ----------------------- | -------------------------------------------- |
| `input` | `InventoryDeleteInput!` | The input fields for deleting the inventory. |

**Input types:**

<details>

<summary>InventoryDeleteInput</summary>

Input for deleting an inventory.

| Field     | Type  | Description                                                                                     |
| --------- | ----- | ----------------------------------------------------------------------------------------------- |
| `id`      | `ID!` | The inventory ID to delete.                                                                     |
| `version` | `Int` | The current version for optimistic locking. If omitted, auto-increments without conflict check. |

</details>

**Output types:**

<details>

<summary>DeletePayload</summary>

The result of a delete mutation.

| Field       | Type  | Description                   |
| ----------- | ----- | ----------------------------- |
| `deletedId` | `ID!` | The ID of the deleted entity. |

</details>

***

### deviceInventoryLink

Links a device to an inventory.

```graphql
deviceInventoryLink(
    input: DeviceInventoryLinkInput!
  ): DeviceInventoryRelationPayload
```

**Arguments**

| Name    | Type                        | Description                              |
| ------- | --------------------------- | ---------------------------------------- |
| `input` | `DeviceInventoryLinkInput!` | The input fields for linking the device. |

**Input types:**

<details>

<summary>DeviceInventoryLinkInput</summary>

Input for linking a device to an inventory. Both device and inventory must belong to the same organization.

| Field         | Type  | Description                                                       |
| ------------- | ----- | ----------------------------------------------------------------- |
| `deviceId`    | `ID!` | The device ID.                                                    |
| `inventoryId` | `ID!` | The inventory ID. Must be in the same organization as the device. |

</details>

**Output types:**

<details>

<summary>DeviceInventoryRelationPayload</summary>

The result of a device inventory link mutation.

| Field                     | Type                                                      | Description                       |
| ------------------------- | --------------------------------------------------------- | --------------------------------- |
| `deviceInventoryRelation` | [DeviceInventoryRelation](#type-deviceinventoryrelation)! | The created inventory assignment. |

</details>

<details>

<summary>DeviceInventoryRelation (entity)</summary>

A record of a device's assignment to an inventory.

**Implements:** [Node](/docs/navixy-repository-api/core-api-reference/common.md#type-node)

| Field        | Type                                                                                   | Description                                                                          |
| ------------ | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| `id`         | `ID!`                                                                                  | A globally unique identifier. This ID is opaque and should not be parsed by clients. |
| `device`     | [Device](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-device)! | The device that was assigned.                                                        |
| `inventory`  | [Inventory](#type-inventory)!                                                          | The inventory the device was assigned to.                                            |
| `assignedAt` | `DateTime!`                                                                            | The date and time when the device was assigned.                                      |
| `assignedBy` | [Actor](/docs/navixy-repository-api/core-api-reference/actors.md#type-actor)           | The actor who assigned the device.                                                   |

</details>

***

### deviceInventoryUnlink

Unlinks a device from an inventory.

```graphql
deviceInventoryUnlink(
    input: DeviceInventoryUnlinkInput!
  ): DeletePayload
```

**Arguments**

| Name    | Type                          | Description                                |
| ------- | ----------------------------- | ------------------------------------------ |
| `input` | `DeviceInventoryUnlinkInput!` | The input fields for unlinking the device. |

**Input types:**

<details>

<summary>DeviceInventoryUnlinkInput</summary>

Input for unlinking a device from an inventory.

| Field      | Type  | Description              |
| ---------- | ----- | ------------------------ |
| `deviceId` | `ID!` | The device ID to unlink. |

</details>

**Output types:**

<details>

<summary>DeletePayload</summary>

The result of a delete mutation.

| Field       | Type  | Description                   |
| ----------- | ----- | ----------------------------- |
| `deletedId` | `ID!` | The ID of the deleted entity. |

</details>

***

## Objects

### DeviceInventoryRelation

A record of a device's assignment to an inventory.

**Implements:** [Node](/docs/navixy-repository-api/core-api-reference/common.md#type-node)

| Field        | Type                                                                                   | Description                                                                          |
| ------------ | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| `id`         | `ID!`                                                                                  | A globally unique identifier. This ID is opaque and should not be parsed by clients. |
| `device`     | [Device](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-device)! | The device that was assigned.                                                        |
| `inventory`  | [Inventory](#type-inventory)!                                                          | The inventory the device was assigned to.                                            |
| `assignedAt` | `DateTime!`                                                                            | The date and time when the device was assigned.                                      |
| `assignedBy` | [Actor](/docs/navixy-repository-api/core-api-reference/actors.md#type-actor)           | The actor who assigned the device.                                                   |

***

### Inventory

An inventory or warehouse record for device stock management.

**Implements:** [Node](/docs/navixy-repository-api/core-api-reference/common.md#type-node), [Versioned](/docs/navixy-repository-api/core-api-reference/common.md#type-versioned), [Titled](/docs/navixy-repository-api/core-api-reference/common.md#type-titled)

| 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.                                                                                                                                                                          |
| `organization` | [Organization](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organization)!         | The organization that owns this inventory.                                                                                                                                                                |
| `devices`      | [DeviceConnection](/docs/navixy-repository-api/core-api-reference/devices/types.md#type-deviceconnection)! | The devices assigned to this inventory.                                                                                                                                                                   |

***

### InventoryPayload

The result of an inventory mutation.

| Field       | Type                          | Description                       |
| ----------- | ----------------------------- | --------------------------------- |
| `inventory` | [Inventory](#type-inventory)! | The created or updated inventory. |

***

### DeviceInventoryRelationPayload

The result of a device inventory link mutation.

| Field                     | Type                                                      | Description                       |
| ------------------------- | --------------------------------------------------------- | --------------------------------- |
| `deviceInventoryRelation` | [DeviceInventoryRelation](#type-deviceinventoryrelation)! | The created inventory assignment. |

***

## Inputs

### DeviceInventoryRelationOrder

Ordering options for device inventory relations.

| Field       | Type                                                                                            | Description             |
| ----------- | ----------------------------------------------------------------------------------------------- | ----------------------- |
| `field`     | [DeviceInventoryRelationOrderField](#type-deviceinventoryrelationorderfield)!                   | The field to order by.  |
| `direction` | [OrderDirection](/docs/navixy-repository-api/core-api-reference/common.md#type-orderdirection)! | The direction to order. |

***

### InventoryFilter

Filtering options for inventories.

| Field           | Type     | Description                                         |
| --------------- | -------- | --------------------------------------------------- |
| `titleContains` | `String` | Partial match on title (case-insensitive contains). |

***

### InventoryOrder

Ordering options for inventories.

| Field       | Type                                                                                            | Description             |
| ----------- | ----------------------------------------------------------------------------------------------- | ----------------------- |
| `field`     | [InventoryOrderField](#type-inventoryorderfield)!                                               | The field to order by.  |
| `direction` | [OrderDirection](/docs/navixy-repository-api/core-api-reference/common.md#type-orderdirection)! | The direction to order. |

***

### InventoryCreateInput

Input for creating a new inventory.

| Field            | Type      | Description                                   |
| ---------------- | --------- | --------------------------------------------- |
| `organizationId` | `ID!`     | The organization that will own the inventory. |
| `title`          | `String!` | The display name.                             |

***

### InventoryUpdateInput

Input for updating an existing inventory.

| Field     | Type     | Description                                                                                     |
| --------- | -------- | ----------------------------------------------------------------------------------------------- |
| `id`      | `ID!`    | The inventory ID to update.                                                                     |
| `version` | `Int`    | The current version for optimistic locking. If omitted, auto-increments without conflict check. |
| `title`   | `String` | The new display name.                                                                           |

***

### InventoryDeleteInput

Input for deleting an inventory.

| Field     | Type  | Description                                                                                     |
| --------- | ----- | ----------------------------------------------------------------------------------------------- |
| `id`      | `ID!` | The inventory ID to delete.                                                                     |
| `version` | `Int` | The current version for optimistic locking. If omitted, auto-increments without conflict check. |

***

### DeviceInventoryLinkInput

Input for linking a device to an inventory. Both device and inventory must belong to the same organization.

| Field         | Type  | Description                                                       |
| ------------- | ----- | ----------------------------------------------------------------- |
| `deviceId`    | `ID!` | The device ID.                                                    |
| `inventoryId` | `ID!` | The inventory ID. Must be in the same organization as the device. |

***

### DeviceInventoryUnlinkInput

Input for unlinking a device from an inventory.

| Field      | Type  | Description              |
| ---------- | ----- | ------------------------ |
| `deviceId` | `ID!` | The device ID to unlink. |

***

## Enums

### DeviceInventoryRelationOrderField

Fields available for ordering device inventory relations.

| Value         | Description               |
| ------------- | ------------------------- |
| `ASSIGNED_AT` | Order by assignment date. |

***

### InventoryOrderField

Fields available for ordering inventories.

| Value   | Description     |
| ------- | --------------- |
| `TITLE` | Order by title. |

***

## Interfaces

### InventoryItem

An object that can be assigned to an inventory.

**Implements:** [Node](/docs/navixy-repository-api/core-api-reference/common.md#type-node)

| Field       | Type                         | Description                                       |
| ----------- | ---------------------------- | ------------------------------------------------- |
| `id`        | `ID!`                        | A globally unique identifier.                     |
| `inventory` | [Inventory](#type-inventory) | The inventory this item is currently assigned to. |

***

## Pagination types

### InventoryConnection

A paginated list of Inventory items.

**Implements:** [Connection](/docs/navixy-repository-api/core-api-reference/common.md#type-connection)

| Field      | Type                                                                                 | Description                                                |
| ---------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------- |
| `edges`    | \[[InventoryEdge](#type-inventoryedge)!]!                                            | A list of edges.                                           |
| `nodes`    | \[[Inventory](#type-inventory)!]!                                                    | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-pageinfo)!  | Information about the current page.                        |
| `total`    | [CountInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-countinfo) | The total count of items matching the filter.              |

***

### InventoryEdge

An edge in the Inventory connection.

**Implements:** [Edge](/docs/navixy-repository-api/core-api-reference/common.md#type-edge)

| Field    | Type                          | Description                           |
| -------- | ----------------------------- | ------------------------------------- |
| `cursor` | `String!`                     | An opaque cursor for this edge.       |
| `node`   | [Inventory](#type-inventory)! | The inventory at the end of the edge. |

***

### DeviceInventoryRelationConnection

A paginated list of DeviceInventoryRelation items.

**Implements:** [Connection](/docs/navixy-repository-api/core-api-reference/common.md#type-connection)

| Field      | Type                                                                                 | Description                                                |
| ---------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------- |
| `edges`    | \[[DeviceInventoryRelationEdge](#type-deviceinventoryrelationedge)!]!                | A list of edges.                                           |
| `nodes`    | \[[DeviceInventoryRelation](#type-deviceinventoryrelation)!]!                        | A list of nodes in the connection (without edge metadata). |
| `pageInfo` | [PageInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-pageinfo)!  | Information about the current page.                        |
| `total`    | [CountInfo](/docs/navixy-repository-api/core-api-reference/common.md#type-countinfo) | The total count of items matching the filter.              |

***

### DeviceInventoryRelationEdge

An edge in the DeviceInventoryRelation connection.

**Implements:** [Edge](/docs/navixy-repository-api/core-api-reference/common.md#type-edge)

| Field    | Type                                                      | Description                                           |
| -------- | --------------------------------------------------------- | ----------------------------------------------------- |
| `cursor` | `String!`                                                 | An opaque cursor for this edge.                       |
| `node`   | [DeviceInventoryRelation](#type-deviceinventoryrelation)! | The device inventory relation at the end of the edge. |

***


---

# Agent Instructions: 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:

```
GET https://navixy.com/docs/navixy-repository-api/core-api-reference/devices/inventory.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.