> 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-repository-api/core-api-reference/catalogs/catalog-items.md).

# Catalog items

{% 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 %}

Operations and types for managing catalog items - the configurable lookup entries.

## Queries

### catalog

Retrieves a catalog by its ID.

```graphql
catalog(id: ID!): Catalog
```

**Arguments**

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

**Output types:**

<details>

<summary>Catalog</summary>

A catalog definition that contains catalog items. Catalogs are themselves catalog items.

**Implements:** [CatalogItem](#type-catalogitem), [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.                                                   |
| `version`      | `Int!`                                                                                            | The version number for optimistic locking.                                      |
| `title`        | `String!`                                                                                         | The human-readable display name. Can be localized.                              |
| `code`         | `Code!`                                                                                           | A machine-readable code, unique within the catalog scope.                       |
| `order`        | `Int!`                                                                                            | The display order within the same level or category.                            |
| `catalog`      | [Catalog](#type-catalog)!                                                                         | Self-reference for the meta-catalog.                                            |
| `organization` | [Organization](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organization) | The organization that owns this item. Null for system items.                    |
| `meta`         | [CatalogItemMeta](#type-catalogitemmeta)!                                                         | Metadata about this item including description, origin, and display properties. |
| `module`       | [Module](/docs/navixy-repository-api/core-api-reference/catalogs/system.md#type-module)!          | The module this catalog is associated with.                                     |
| `items`        | [CatalogItemConnection](#type-catalogitemconnection)!                                             | The items in this catalog.                                                      |

</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>

***

### catalogs

Lists catalogs for an organization.

```graphql
catalogs(
    organizationId: ID!
    filter: CatalogItemFilter
    first: Int
    after: String
    last: Int
    before: String
    orderBy: CatalogItemOrder = { field: ORDER, direction: ASC }
  ): CatalogConnection!
```

**Arguments**

| Name             | Type                | Description                                                                                      |
| ---------------- | ------------------- | ------------------------------------------------------------------------------------------------ |
| `organizationId` | `ID!`               | The organization to retrieve catalogs for.                                                       |
| `filter`         | `CatalogItemFilter` | Filtering options for the returned catalogs.                                                     |
| `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`        | `CatalogItemOrder`  | The ordering options for the returned catalogs.                                                  |

**Input types:**

<details>

<summary>CatalogItemFilter</summary>

Filtering options for catalog items.

| Field           | Type      | Description                                         |
| --------------- | --------- | --------------------------------------------------- |
| `titleContains` | `String`  | Partial match on title (case-insensitive contains). |
| `codes`         | `[Code!]` | Match any of these codes.                           |

</details>

<details>

<summary>CatalogItemOrder</summary>

Ordering options for catalog items.

| Field       | Type                                                                                            | Description             |
| ----------- | ----------------------------------------------------------------------------------------------- | ----------------------- |
| `field`     | [CatalogItemOrderField](#type-catalogitemorderfield)!                                           | 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>CatalogConnection</summary>

A paginated list of Catalog items.

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

| Field      | Type                                                                                 | Description                                                |
| ---------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------- |
| `edges`    | \[[CatalogEdge](#type-catalogedge)!]!                                                | A list of edges.                                           |
| `nodes`    | \[[Catalog](#type-catalog)!]!                                                        | 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

### catalogCreate

Creates a new user-defined catalog.

```graphql
catalogCreate(
    input: CatalogCreateInput!
  ): CatalogPayload
```

**Arguments**

| Name    | Type                  | Description                                |
| ------- | --------------------- | ------------------------------------------ |
| `input` | `CatalogCreateInput!` | The input fields for creating the catalog. |

**Input types:**

<details>

<summary>CatalogCreateInput</summary>

Input for creating a user-defined catalog (a container for user catalog items).

| Field            | Type                                               | Description                                                                                      |
| ---------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| `organizationId` | `ID!`                                              | The organization that will own the catalog.                                                      |
| `moduleId`       | `ID`                                               | The module this catalog belongs to. Defaults to CORE if omitted.                                 |
| `code`           | `Code`                                             | The machine-readable code, unique within the organization. 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](#type-catalogitemmetainput) | The display properties.                                                                          |

</details>

<details>

<summary>CatalogItemMetaInput</summary>

Display properties for catalog items.

| Field         | Type      | Description                                       |
| ------------- | --------- | ------------------------------------------------- |
| `description` | `String`  | The description.                                  |
| `hidden`      | `Boolean` | Whether the item is hidden from regular UI lists. |

</details>

**Output types:**

<details>

<summary>CatalogPayload</summary>

The result of a catalog mutation.

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

</details>

<details>

<summary>Catalog (entity)</summary>

A catalog definition that contains catalog items. Catalogs are themselves catalog items.

**Implements:** [CatalogItem](#type-catalogitem), [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.                                                   |
| `version`      | `Int!`                                                                                            | The version number for optimistic locking.                                      |
| `title`        | `String!`                                                                                         | The human-readable display name. Can be localized.                              |
| `code`         | `Code!`                                                                                           | A machine-readable code, unique within the catalog scope.                       |
| `order`        | `Int!`                                                                                            | The display order within the same level or category.                            |
| `catalog`      | [Catalog](#type-catalog)!                                                                         | Self-reference for the meta-catalog.                                            |
| `organization` | [Organization](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organization) | The organization that owns this item. Null for system items.                    |
| `meta`         | [CatalogItemMeta](#type-catalogitemmeta)!                                                         | Metadata about this item including description, origin, and display properties. |
| `module`       | [Module](/docs/navixy-repository-api/core-api-reference/catalogs/system.md#type-module)!          | The module this catalog is associated with.                                     |
| `items`        | [CatalogItemConnection](#type-catalogitemconnection)!                                             | The items in this catalog.                                                      |

</details>

***

### catalogUpdate

Updates a user-defined catalog.

```graphql
catalogUpdate(
    input: CatalogUpdateInput!
  ): CatalogPayload
```

**Arguments**

| Name    | Type                  | Description                                |
| ------- | --------------------- | ------------------------------------------ |
| `input` | `CatalogUpdateInput!` | The input fields for updating the catalog. |

**Input types:**

<details>

<summary>CatalogUpdateInput</summary>

Input for updating a user-defined catalog.

| Field     | Type                                               | Description                                                                                     |
| --------- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `id`      | `ID!`                                              | The catalog 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](#type-catalogitemmetainput) | The display properties.                                                                         |

</details>

<details>

<summary>CatalogItemMetaInput</summary>

Display properties for catalog items.

| Field         | Type      | Description                                       |
| ------------- | --------- | ------------------------------------------------- |
| `description` | `String`  | The description.                                  |
| `hidden`      | `Boolean` | Whether the item is hidden from regular UI lists. |

</details>

**Output types:**

<details>

<summary>CatalogPayload</summary>

The result of a catalog mutation.

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

</details>

<details>

<summary>Catalog (entity)</summary>

A catalog definition that contains catalog items. Catalogs are themselves catalog items.

**Implements:** [CatalogItem](#type-catalogitem), [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.                                                   |
| `version`      | `Int!`                                                                                            | The version number for optimistic locking.                                      |
| `title`        | `String!`                                                                                         | The human-readable display name. Can be localized.                              |
| `code`         | `Code!`                                                                                           | A machine-readable code, unique within the catalog scope.                       |
| `order`        | `Int!`                                                                                            | The display order within the same level or category.                            |
| `catalog`      | [Catalog](#type-catalog)!                                                                         | Self-reference for the meta-catalog.                                            |
| `organization` | [Organization](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organization) | The organization that owns this item. Null for system items.                    |
| `meta`         | [CatalogItemMeta](#type-catalogitemmeta)!                                                         | Metadata about this item including description, origin, and display properties. |
| `module`       | [Module](/docs/navixy-repository-api/core-api-reference/catalogs/system.md#type-module)!          | The module this catalog is associated with.                                     |
| `items`        | [CatalogItemConnection](#type-catalogitemconnection)!                                             | The items in this catalog.                                                      |

</details>

***

### catalogDelete

Deletes a user-defined catalog.

```graphql
catalogDelete(
    input: CatalogDeleteInput!
  ): DeletePayload
```

**Arguments**

| Name    | Type                  | Description                                |
| ------- | --------------------- | ------------------------------------------ |
| `input` | `CatalogDeleteInput!` | The input fields for deleting the catalog. |

**Input types:**

<details>

<summary>CatalogDeleteInput</summary>

Input for deleting a user-defined catalog.

| Field     | Type  | Description                                                                            |
| --------- | ----- | -------------------------------------------------------------------------------------- |
| `id`      | `ID!` | The catalog ID to delete.                                                              |
| `version` | `Int` | The current version for optimistic locking. If omitted, deletes regardless of version. |

</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

### CatalogItemMeta

Metadata about a catalog item.

| Field          | Type                                          | Description                                                                                          |
| -------------- | --------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| `description`  | `String`                                      | A description of the catalog item. Can be localized.                                                 |
| `origin`       | [CatalogItemOrigin](#type-catalogitemorigin)! | The origin indicating how this item was created.                                                     |
| `canBeDeleted` | `Boolean!`                                    | Whether this item can be deleted. Returns `false` if the item has dependencies or is system-managed. |
| `hidden`       | `Boolean!`                                    | Whether this item is hidden from regular UI lists.                                                   |

***

### Catalog

A catalog definition that contains catalog items. Catalogs are themselves catalog items.

**Implements:** [CatalogItem](#type-catalogitem), [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.                                                   |
| `version`      | `Int!`                                                                                            | The version number for optimistic locking.                                      |
| `title`        | `String!`                                                                                         | The human-readable display name. Can be localized.                              |
| `code`         | `Code!`                                                                                           | A machine-readable code, unique within the catalog scope.                       |
| `order`        | `Int!`                                                                                            | The display order within the same level or category.                            |
| `catalog`      | [Catalog](#type-catalog)!                                                                         | Self-reference for the meta-catalog.                                            |
| `organization` | [Organization](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organization) | The organization that owns this item. Null for system items.                    |
| `meta`         | [CatalogItemMeta](#type-catalogitemmeta)!                                                         | Metadata about this item including description, origin, and display properties. |
| `module`       | [Module](/docs/navixy-repository-api/core-api-reference/catalogs/system.md#type-module)!          | The module this catalog is associated with.                                     |
| `items`        | [CatalogItemConnection](#type-catalogitemconnection)!                                             | The items in this catalog.                                                      |

***

### CatalogPayload

The result of a catalog mutation.

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

***

## Inputs

### CatalogItemFilter

Filtering options for catalog items.

| Field           | Type      | Description                                         |
| --------------- | --------- | --------------------------------------------------- |
| `titleContains` | `String`  | Partial match on title (case-insensitive contains). |
| `codes`         | `[Code!]` | Match any of these codes.                           |

***

### CatalogItemChildrenFilter

Filtering options for catalog item children.

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

***

### CatalogItemOrder

Ordering options for catalog items.

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

***

### CatalogItemMetaInput

Display properties for catalog items.

| Field         | Type      | Description                                       |
| ------------- | --------- | ------------------------------------------------- |
| `description` | `String`  | The description.                                  |
| `hidden`      | `Boolean` | Whether the item is hidden from regular UI lists. |

***

### CatalogCreateInput

Input for creating a user-defined catalog (a container for user catalog items).

| Field            | Type                                               | Description                                                                                      |
| ---------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| `organizationId` | `ID!`                                              | The organization that will own the catalog.                                                      |
| `moduleId`       | `ID`                                               | The module this catalog belongs to. Defaults to CORE if omitted.                                 |
| `code`           | `Code`                                             | The machine-readable code, unique within the organization. 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](#type-catalogitemmetainput) | The display properties.                                                                          |

***

### CatalogUpdateInput

Input for updating a user-defined catalog.

| Field     | Type                                               | Description                                                                                     |
| --------- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `id`      | `ID!`                                              | The catalog 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](#type-catalogitemmetainput) | The display properties.                                                                         |

***

### CatalogDeleteInput

Input for deleting a user-defined catalog.

| Field     | Type  | Description                                                                            |
| --------- | ----- | -------------------------------------------------------------------------------------- |
| `id`      | `ID!` | The catalog ID to delete.                                                              |
| `version` | `Int` | The current version for optimistic locking. If omitted, deletes regardless of version. |

***

### 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. |

***

## Enums

### CatalogItemOrigin

The origin of a catalog item, indicating how it was created.

| Value                 | Description                                                           |
| --------------------- | --------------------------------------------------------------------- |
| `SYSTEM`              | Predefined by platform. Immutable and available to all organizations. |
| `ORGANIZATION`        | Created by the current organization.                                  |
| `PARENT_ORGANIZATION` | Inherited from a parent organization in the dealer hierarchy.         |

***

### CatalogItemOrderField

Fields available for ordering catalog items.

| Value        | Description                      |
| ------------ | -------------------------------- |
| `ORDER`      | Order by display order.          |
| `CODE`       | Order by code.                   |
| `TITLE`      | Order by title.                  |
| `CREATED_AT` | Order by creation date and time. |

***

## Interfaces

### CatalogItem

A dictionary item that provides reference data for the system.

**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.                                                   |
| `version`      | `Int!`                                                                                            | The version number for optimistic locking.                                      |
| `title`        | `String!`                                                                                         | The human-readable display name. Can be localized.                              |
| `code`         | `Code!`                                                                                           | A machine-readable code, unique within the catalog scope.                       |
| `order`        | `Int!`                                                                                            | The display order within the same level or category.                            |
| `catalog`      | [Catalog](#type-catalog)!                                                                         | The catalog this item belongs to.                                               |
| `organization` | [Organization](/docs/navixy-repository-api/core-api-reference/organizations.md#type-organization) | The organization that owns this item. Null for system items.                    |
| `meta`         | [CatalogItemMeta](#type-catalogitemmeta)!                                                         | Metadata about this item including description, origin, and display properties. |

***

### HierarchicalCatalogItem

A catalog item that supports parent-child hierarchy.

| Field    | Type                             | Description                                            |
| -------- | -------------------------------- | ------------------------------------------------------ |
| `parent` | [CatalogItem](#type-catalogitem) | The parent item in the hierarchy. Null for root items. |

***

## Pagination types

### CatalogItemConnection

A paginated list of CatalogItem items.

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

| Field      | Type                                                                                 | Description                                                |
| ---------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------- |
| `edges`    | \[[CatalogItemEdge](#type-catalogitemedge)!]!                                        | A list of edges.                                           |
| `nodes`    | \[[CatalogItem](#type-catalogitem)!]!                                                | 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.              |

***

### CatalogItemEdge

An edge in the CatalogItem 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`   | [CatalogItem](#type-catalogitem)! | The catalog item at the end of the edge. |

***

### CatalogConnection

A paginated list of Catalog items.

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

| Field      | Type                                                                                 | Description                                                |
| ---------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------- |
| `edges`    | \[[CatalogEdge](#type-catalogedge)!]!                                                | A list of edges.                                           |
| `nodes`    | \[[Catalog](#type-catalog)!]!                                                        | 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.              |

***

### CatalogEdge

An edge in the Catalog 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`   | [Catalog](#type-catalog)! | The catalog at the end of the edge. |

***


---

# 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-repository-api/core-api-reference/catalogs/catalog-items.md?ask=<question>&goal=<endgoal>
```

`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.