Mutations

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.

assetCreate

Creates a new asset.

assetCreate(
    input: AssetCreateInput!
  ): AssetPayload

Arguments

Name	Type	Description
input	AssetCreateInput!	The input fields for creating the asset.

Input types:

AssetCreateInput

Input for creating a new asset.

Field	Type	Description
organizationId	ID!	The organization that will own the asset.
typeId	ID!	The asset type ID.
title	String!	The asset display name.
customFields	CustomFieldsPatchInput	The custom field values.

CustomFieldsPatchInput

Input for updating custom field values using a patch model.

Field	Type	Description
set	JSON	Fields to set or update as a key-value map.
unset	[Code!]	Field codes to remove.

Output types:

AssetPayload

The result of an asset mutation.

Field	Type	Description
asset	Asset!	The created or updated asset.

Asset (entity)

A physical or logical asset being tracked.

Implements: Node, Titled, Customizable, Versioned

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 asset.
type	AssetType!	The asset type classification.
customFields	JSON!	Custom field values as a key-value map. Keys are CustomFieldDefinition codes.
device	Device	The primary tracking device linked to this asset. This is an alias for the device custom field.
groups	AssetGroupConnection!	The groups this asset belongs to.

---

assetUpdate

Updates an existing asset.

assetUpdate(
    input: AssetUpdateInput!
  ): AssetPayload

Arguments

Name	Type	Description
input	AssetUpdateInput!	The input fields for updating the asset.

Input types:

AssetUpdateInput

Input for updating an existing asset.

Field	Type	Description
id	ID!	The asset ID to update.
version	Int!	The current version for optimistic locking.
title	String	The new display name.
customFields	CustomFieldsPatchInput	The custom field changes.

CustomFieldsPatchInput

Input for updating custom field values using a patch model.

Field	Type	Description
set	JSON	Fields to set or update as a key-value map.
unset	[Code!]	Field codes to remove.

Output types:

AssetPayload

The result of an asset mutation.

Field	Type	Description
asset	Asset!	The created or updated asset.

Asset (entity)

A physical or logical asset being tracked.

Implements: Node, Titled, Customizable, Versioned

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 asset.
type	AssetType!	The asset type classification.
customFields	JSON!	Custom field values as a key-value map. Keys are CustomFieldDefinition codes.
device	Device	The primary tracking device linked to this asset. This is an alias for the device custom field.
groups	AssetGroupConnection!	The groups this asset belongs to.

---

assetDelete

Deletes an asset.

assetDelete(
    input: AssetDeleteInput!
  ): DeletePayload

Arguments

Name	Type	Description
input	AssetDeleteInput!	The input fields for deleting the asset.

Input types:

AssetDeleteInput

Input for deleting an asset.

Field	Type	Description
id	ID!	The asset 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.

---

assetTypeCreate

Creates a new asset type.

assetTypeCreate(
    input: AssetTypeCreateInput!
  ): AssetTypePayload

Arguments

Name	Type	Description
input	AssetTypeCreateInput!	The input fields for creating the asset type.

Input types:

AssetTypeCreateInput

Input for creating an asset type.

Field	Type	Description
organizationId	ID!	The organization that will own the item.
code	Code!	The machine-readable code.
title	String!	The display name.
order	Int	The display order.
meta	CatalogItemMetaInput	The display properties.

CatalogItemMetaInput

Display properties for catalog items.

Field	Type	Description
description	String	The description.
hidden	Boolean	Whether the item is hidden from regular UI lists.
textColor	HexColorCode	The text color for UI display.
backgroundColor	HexColorCode	The background color for UI display.
icon	String	A relative URL to the icon.

Output types:

AssetTypePayload

The result of an asset type mutation.

Field	Type	Description
assetType	AssetType!	The created or updated asset type.

AssetType (entity)

A classification type for assets.

Implements: CatalogItem, Node, Versioned, 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!	The catalog this item belongs to.
organization	Organization	The organization that owns this item. Null for system items.
meta	CatalogItemMeta!	Metadata about this item including description, origin, and display properties.
customFieldDefinitions	[CustomFieldDefinition!]!	Custom field definitions specific to this asset type, ordered by display order.

---

assetTypeUpdate

Updates an asset type.

assetTypeUpdate(
    input: AssetTypeUpdateInput!
  ): AssetTypePayload

Arguments

Name	Type	Description
input	AssetTypeUpdateInput!	The input fields for updating the asset type.

Input types:

AssetTypeUpdateInput

Input for updating an asset type.

Field	Type	Description
id	ID!	The item ID to update.
version	Int!	The current version for optimistic locking.
title	String	The new display name.
order	Int	The new display order.
meta	CatalogItemMetaInput	The display properties.

CatalogItemMetaInput

Display properties for catalog items.

Field	Type	Description
description	String	The description.
hidden	Boolean	Whether the item is hidden from regular UI lists.
textColor	HexColorCode	The text color for UI display.
backgroundColor	HexColorCode	The background color for UI display.
icon	String	A relative URL to the icon.

Output types:

AssetTypePayload

The result of an asset type mutation.

Field	Type	Description
assetType	AssetType!	The created or updated asset type.

AssetType (entity)

A classification type for assets.

Implements: CatalogItem, Node, Versioned, 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!	The catalog this item belongs to.
organization	Organization	The organization that owns this item. Null for system items.
meta	CatalogItemMeta!	Metadata about this item including description, origin, and display properties.
customFieldDefinitions	[CustomFieldDefinition!]!	Custom field definitions specific to this asset type, ordered by display order.

---

assetTypeDelete

Deletes an asset type.

assetTypeDelete(
    input: CatalogItemDeleteInput!
  ): DeletePayload

Arguments

Name	Type	Description
input	CatalogItemDeleteInput!	The input fields for deleting the asset type.

Input types:

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.

Output types:

DeletePayload

The result of a delete mutation.

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

---