Organizations

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.

Organizations form the top-level container for all business data. Each organization operates as an isolated tenant with its own users, devices, assets, and configuration.

Queries

organization

Retrieves an organization by its ID.

organization(id: ID!): Organization

Arguments

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

Output types:

Organization

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.

OrganizationConnection (entity)

A paginated list of Organization items.

Implements: Connection

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

---

organizations

Lists organizations.

organizations(
    filter: OrganizationFilter
    first: Int
    after: String
    last: Int
    before: String
    orderBy: OrganizationOrder = { field: TITLE, direction: ASC }
  ): OrganizationConnection!

Arguments

Name	Type	Description
filter	OrganizationFilter	Filtering options for the returned organizations.
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	OrganizationOrder	The ordering options for the returned organizations.

Input types:

OrganizationFilter

Filtering options for organizations.

Field	Type	Description
parentIds	[ID!]	Filter by parent organizations (OR within field).
isActive	Boolean	Filter by active status.

OrganizationOrder

Ordering options for organizations.

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

Output types:

OrganizationConnection

A paginated list of Organization items.

Implements: Connection

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

---

Mutations

organizationCreate

Creates a new organization.

organizationCreate(
    input: OrganizationCreateInput!
  ): OrganizationPayload

Arguments

Name	Type	Description
input	OrganizationCreateInput!	The input fields for creating the organization.

Input types:

OrganizationCreateInput

Input for creating a new organization.

Field	Type	Description
parentId	ID	The parent organization ID. Null for root organizations.
title	String!	The display name.
externalId	String	An external system identifier.
features	[OrganizationFeature!]	The feature flags to enable.

Output types:

OrganizationPayload

The result of an organization mutation.

Field	Type	Description
organization	Organization!	The created or updated organization.

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.

---

organizationUpdate

Updates an existing organization.

organizationUpdate(
    input: OrganizationUpdateInput!
  ): OrganizationPayload

Arguments

Name	Type	Description
input	OrganizationUpdateInput!	The input fields for updating the organization.

Input types:

OrganizationUpdateInput

Input for updating an existing organization.

Field	Type	Description
id	ID!	The organization ID to update.
version	Int!	The current version for optimistic locking.
title	String	The new display name.
externalId	String	The new external identifier.
isActive	Boolean	The new active status.
features	[OrganizationFeature!]	The new feature flags.

Output types:

OrganizationPayload

The result of an organization mutation.

Field	Type	Description
organization	Organization!	The created or updated organization.

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.

---

organizationDelete

Deletes an organization and all its data.

organizationDelete(
    input: OrganizationDeleteInput!
  ): DeletePayload

Arguments

Name	Type	Description
input	OrganizationDeleteInput!	The input fields for deleting the organization.

Input types:

OrganizationDeleteInput

Input for deleting an organization and all its data.

Field	Type	Description
id	ID!	The organization ID to delete.
version	Int!	The current version for optimistic locking.

Output types:

DeletePayload

The result of a delete mutation.

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

---

Objects

Organization

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.

---

OrganizationPayload

The result of an organization mutation.

Field	Type	Description
organization	Organization!	The created or updated organization.

---

Inputs

OrganizationFilter

Filtering options for organizations.

Field	Type	Description
parentIds	[ID!]	Filter by parent organizations (OR within field).
isActive	Boolean	Filter by active status.

---

OrganizationChildrenFilter

Filtering options for organization children. Excludes parentId as it is implicit.

Field	Type	Description
isActive	Boolean	Filter by active status.
titleContains	String	Partial match on title (case-insensitive contains).

---

OrganizationOrder

Ordering options for organizations.

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

---

OrganizationCreateInput

Input for creating a new organization.

Field	Type	Description
parentId	ID	The parent organization ID. Null for root organizations.
title	String!	The display name.
externalId	String	An external system identifier.
features	[OrganizationFeature!]	The feature flags to enable.

---

OrganizationUpdateInput

Input for updating an existing organization.

Field	Type	Description
id	ID!	The organization ID to update.
version	Int!	The current version for optimistic locking.
title	String	The new display name.
externalId	String	The new external identifier.
isActive	Boolean	The new active status.
features	[OrganizationFeature!]	The new feature flags.

---

OrganizationDeleteInput

Input for deleting an organization and all its data.

Field	Type	Description
id	ID!	The organization ID to delete.
version	Int!	The current version for optimistic locking.

---

Enums

OrganizationFeature

Feature flags that can be enabled for an organization.

Value	Description
DEALER	The organization can create and manage child organizations (dealer/reseller model).
WHITELABEL	The organization has custom branding including domain, logo, and color scheme.

---

OrganizationOrderField

Fields available for ordering organizations.

Value	Description
TITLE	Order by title.

---

Pagination types

OrganizationConnection

A paginated list of Organization items.

Implements: Connection

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

---

OrganizationEdge

An edge in the Organization connection.

Implements: Edge

Field	Type	Description
cursor	String!	An opaque cursor for this edge.
node	Organization!	The organization at the end of the edge.

---