Queries

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.

deviceTypes

Lists device types for an organization.

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

Arguments

Name	Type	Description
organizationId	ID!	The organization to retrieve device types for.
filter	CatalogItemFilter	Filtering options for the returned device types.
first	Int	The first n elements from the paginated list.
after	String	The elements that come after the specified cursor.
last	Int	The last n elements from the paginated list.
before	String	The elements that come before the specified cursor.
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!]	Match any of these codes.

CatalogItemOrder

Ordering options for catalog items.

Field	Type	Description
field	CatalogItemOrderField!	The field to order by.
direction	OrderDirection!	The direction to order.

Output types:

DeviceTypeConnection

A paginated list of DeviceType items.

Implements: Connection

Field	Type	Description
edges	[DeviceTypeEdge!]!	A list of edges.
nodes	[DeviceType!]!	A list of nodes in the connection (without edge metadata).
pageInfo	PageInfo!	Information about the current page.
total	CountInfo	The total count of items matching the filter.

PageInfo (entity)

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.

---

deviceStatuses

Lists device statuses for an organization.

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

Arguments

Name	Type	Description
organizationId	ID!	The organization to retrieve device statuses for.
filter	CatalogItemFilter	Filtering options for the returned device statuses.
first	Int	The first n elements from the paginated list.
after	String	The elements that come after the specified cursor.
last	Int	The last n elements from the paginated list.
before	String	The elements that come before the specified cursor.
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!]	Match any of these codes.

CatalogItemOrder

Ordering options for catalog items.

Field	Type	Description
field	CatalogItemOrderField!	The field to order by.
direction	OrderDirection!	The direction to order.

Output types:

DeviceStatusConnection

A paginated list of DeviceStatus items.

Implements: Connection

Field	Type	Description
edges	[DeviceStatusEdge!]!	A list of edges.
nodes	[DeviceStatus!]!	A list of nodes in the connection (without edge metadata).
pageInfo	PageInfo!	Information about the current page.
total	CountInfo	The total count of items matching the filter.

PageInfo (entity)

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.

---

deviceModels

Lists device models with optional vendor filter.

deviceModels(
    organizationId: ID!
    filter: DeviceModelFilter
    first: Int
    after: String
    last: Int
    before: String
    orderBy: CatalogItemOrder = { field: TITLE, direction: ASC }
  ): DeviceModelConnection!

Arguments

Name	Type	Description
organizationId	ID!	The organization to retrieve device models for.
filter	DeviceModelFilter	Filtering options for the returned device models.
first	Int	The first n elements from the paginated list.
after	String	The elements that come after the specified cursor.
last	Int	The last n elements from the paginated list.
before	String	The elements that come before the specified cursor.
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	Exact code match.

CatalogItemOrder

Ordering options for catalog items.

Field	Type	Description
field	CatalogItemOrderField!	The field to order by.
direction	OrderDirection!	The direction to order.

Output types:

DeviceModelConnection

A paginated list of DeviceModel items.

Implements: Connection

Field	Type	Description
edges	[DeviceModelEdge!]!	A list of edges.
nodes	[DeviceModel!]!	A list of nodes in the connection (without edge metadata).
pageInfo	PageInfo!	Information about the current page.
total	CountInfo	The total count of items matching the filter.

PageInfo (entity)

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.

---

device

Retrieves a device by its ID.

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, Titled, Versioned, 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. Must be provided in update/delete mutations to prevent lost updates.
title	String!	The human-readable display name.
organization	Organization!	The organization that owns this device.
type	DeviceType!	The device type classification.
model	DeviceModel!	The specific device model.
status	DeviceStatus!	The current operational status.
identifiers	[DeviceIdentifier!]!	The hardware identifiers for this device (IMEI, serial number, MAC address, etc.).
inventory	Inventory	The inventory this device is currently assigned to.
relationsFrom	[DeviceRelation!]!	The outgoing relationships from this device to other devices.
relationsTo	[DeviceRelation!]!	The incoming relationships from other devices to this device.
inventoryHistory	DeviceInventoryRelationConnection!	The history of inventory assignments for this device.

Organization (entity)

An organization in the hierarchy that owns entities and users.

Implements: Node, Versioned, 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. Must be provided in update/delete mutations to prevent lost updates.
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!]!	The feature flags enabled for this organization.
parent	Organization	The parent organization in the hierarchy. Null for root organizations.
children	OrganizationConnection!	The child organizations.
members	MemberConnection!	The members of this organization.
devices	DeviceConnection!	The devices owned by this organization.
assets	AssetConnection!	The assets owned by this organization.
geoObjects	GeoObjectConnection!	The geographic objects owned by this organization.
schedules	ScheduleConnection!	The schedules owned by this organization.

---

devices

Lists devices for an organization.

devices(
    organizationId: ID!
    filter: DeviceFilter
    first: Int
    after: String
    last: Int
    before: String
    orderBy: DeviceOrder = { field: TITLE, direction: ASC }
  ): DeviceConnection!

Arguments

Name	Type	Description
organizationId	ID!	The organization to retrieve devices for.
filter	DeviceFilter	Filtering options for the returned devices.
first	Int	The first n elements from the paginated list.
after	String	The elements that come after the specified cursor.
last	Int	The last n elements from the paginated list.
before	String	The elements that come before the specified cursor.
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-sensitive 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	The field to order by.
direction	OrderDirection!	The direction to order.

Output types:

DeviceConnection

A paginated list of Device items.

Implements: Connection

Field	Type	Description
edges	[DeviceEdge!]!	A list of edges.
nodes	[Device!]!	A list of nodes in the connection (without edge metadata).
pageInfo	PageInfo!	Information about the current page.
total	CountInfo	The total count of items matching the filter.

PageInfo (entity)

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.

---