Overview

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.

Navixy Repository API is a programming interface for managing the organizational structure and business entities of the Navixy platform. It provides a flexible way to define what you track (assets), how data is collected (devices), where important points are located (geo objects), when things happen (schedules), and who can access what (permissions).

Navixy Repository is based on GraphQL. Unlike REST APIs where you call multiple endpoints to gather related data, GraphQL allows you to request the exact fields you need in a single query. You describe the shape of the data you want, and the API returns it in that shape.

For a quick description of GraphQL concepts, see GraphQL basics.

Purpose and capabilities

Navixy Repository API enables you to:

• Create assets and organize them into groups

• Register devices (GPS trackers, sensors) with hardware identifiers and add them to inventories

• Define geo objects (geofences, points of interest, routes) with GeoJSON geometry

• Create schedules for work hours, maintenance windows, and time-based rules

• Configure custom fields to extend certain entities with organization-specific data

Key concepts

The API is organized around the following core resources:

Term	Definition
Organization	The main tenant in the system hierarchy. Organizations own all other resources.
Asset	A business object you're tracking: a vehicle, piece of equipment, employee, or any other entity. Assets can be linked into asset groups or assigned one or multiple GPS devices.
Device	Physical tracking hardware (GPS tracker, sensor, beacon). Devices have types, models, statuses, and hardware identifiers (IMEI, serial number).
Inventory	A logical grouping of devices for stock management (warehouse, vehicle stock, field inventory).
Geo object	A location-based entity based on the GeoJSON standard: geofence, point of interest, or route.
Schedule	iCalendar-compatible time-based schedules for your operations (maintenance cycles, time shifts).

Navigation

The Navixy Repository API documentation is organized into two complementary sections designed to help you understand concepts and implement solutions.

Section content

These articles provide essential background knowledge and guidelines:

• GraphQL basics: A brief introduction to GraphQL for developers familiar with REST APIs.

• GraphQL tips and patterns: Practical suggestions for improving your GraphQL experience.

• Error handling: Error structure, codes, and common error scenarios.

• Pagination and Filtering and sorting: Instruments for efficient navigating through pages of data and narrowing down results by criteria and order.

• Optimistic locking: How the API handles concurrent updates to prevent conflicting changes from overwriting each other.

• Guides: In-depth guides exploring the most common use cases.

Core API reference

The API reference provides complete technical specifications for all GraphQL types and operations, grouped by category:

• Common resources

• Directives

• Organizations

• Actors

• Devices

• Assets

• Geo objects

• Schedules

• Access control

• Custom fields

• Audit

• Catalogs

The API supports GraphQL introspection for authenticated users. You can perform it via Navixy Repository GraphQL Sandbox (currently in query-only demo mode) or with your own tools. You can also check the public GraphQL schema.