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.

assetGroupTypes

Lists asset group types for an organization.

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

Arguments

Name	Type	Description
organizationId	ID!	The organization to retrieve asset group types for.
filter	CatalogItemFilter	Filtering options for the returned asset group 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 asset group 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:

AssetGroupTypeConnection

A paginated list of AssetGroupType items.

Implements: Connection

Field	Type	Description
edges	[AssetGroupTypeEdge!]!	A list of edges.
nodes	[AssetGroupType!]!	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.

---

assetGroup

Retrieves an asset group by its ID.

assetGroup(id: ID!): AssetGroup

Arguments

Name	Type	Description
id	ID!	The ID of the asset group to retrieve.

Output types:

AssetGroup

A group of assets.

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.
organization	Organization!	The organization that owns this group.
type	AssetGroupType!	The group type with membership constraints.
color	HexColorCode	The color for UI display in hexadecimal format.
currentAssets	AssetConnection!	The assets currently in this group.
history	AssetGroupItemConnection!	The full membership history for this group.

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.

---

assetGroups

Lists asset groups for an organization.

assetGroups(
    organizationId: ID!
    filter: AssetGroupFilter
    first: Int
    after: String
    last: Int
    before: String
    orderBy: AssetGroupOrder = { field: TITLE, direction: ASC }
  ): AssetGroupConnection!

Arguments

Name	Type	Description
organizationId	ID!	The organization to retrieve asset groups for.
filter	AssetGroupFilter	Filtering options for the returned asset groups.
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	AssetGroupOrder	The ordering options for the returned asset groups.

Input types:

AssetGroupFilter

Filtering options for asset groups.

Field	Type	Description
typeIds	[ID!]	Filter by group types (OR within field).
titleContains	String	Partial match on title (case-insensitive contains).

AssetGroupOrder

Ordering options for asset groups.

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

Output types:

AssetGroupConnection

A paginated list of AssetGroup items.

Implements: Connection

Field	Type	Description
edges	[AssetGroupEdge!]!	A list of edges.
nodes	[AssetGroup!]!	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.

---