> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/navixy-repository-api/core-api-reference.md).

# Core API reference

- [Directives](https://navixy.com/docs/navixy-repository-api/core-api-reference/directives.md): GraphQL directives supported by Navixy Repository API, including standard directives and the custom @trim directive.
- [Common resources](https://navixy.com/docs/navixy-repository-api/core-api-reference/common.md): Foundational types, scalars, and interfaces shared across the API, including Node, Titled, Versioned, pagination types, and common scalars like DateTime and Decimal.
- [Organizations](https://navixy.com/docs/navixy-repository-api/core-api-reference/organizations.md): Organizations are the top-level containers for all business data. Each organization operates as an isolated tenant with its own users, devices, assets, and configuration.
- [Members](https://navixy.com/docs/navixy-repository-api/core-api-reference/organizations/members.md): Query reference for organization members, including their roles, permissions, and user profile data within each organization.
- [Actors](https://navixy.com/docs/navixy-repository-api/core-api-reference/actors.md): Actors represent entities that can authenticate and perform actions in the system, including users and integrations.
- [Users](https://navixy.com/docs/navixy-repository-api/core-api-reference/actors/users.md): Queries and mutations for user accounts, including profile lookups and user settings updates.
- [Integrations](https://navixy.com/docs/navixy-repository-api/core-api-reference/actors/integrations.md): Queries and mutations for integration accounts used by API clients, automated systems, and third-party service connections.
- [Devices](https://navixy.com/docs/navixy-repository-api/core-api-reference/devices.md): GPS trackers, sensors, and hardware units. Register devices, manage identifiers, link them to assets, and track inventory assignments.
- [Queries](https://navixy.com/docs/navixy-repository-api/core-api-reference/devices/queries.md): Query reference for devices. List device types, models, and devices with filtering by type, status, identifiers, and custom fields.
- [Mutations](https://navixy.com/docs/navixy-repository-api/core-api-reference/devices/mutations.md): Mutation reference for devices. Create, update, and delete devices, manage identifiers, and link or unlink device relations.
- [Types](https://navixy.com/docs/navixy-repository-api/core-api-reference/devices/types.md): Type definitions for devices, including Device, DeviceType, DeviceModel, identifier types, relation types, and associated inputs and enums.
- [Inventory](https://navixy.com/docs/navixy-repository-api/core-api-reference/devices/inventory.md): Complete reference for device inventory. Manage warehouses, assign devices to inventory locations, and query assignment history.
- [Assets](https://navixy.com/docs/navixy-repository-api/core-api-reference/assets.md): Assets represent trackable business objects such as vehicles, equipment, and other entities your organization needs to monitor and manage.
- [Queries](https://navixy.com/docs/navixy-repository-api/core-api-reference/assets/queries.md): Query reference for assets. List asset types and assets with filtering by type, linked device, title, and custom fields.
- [Mutations](https://navixy.com/docs/navixy-repository-api/core-api-reference/assets/mutations.md): Mutation reference for assets. Create, update, and delete assets, and manage custom field values.
- [Types](https://navixy.com/docs/navixy-repository-api/core-api-reference/assets/types.md): Type definitions for assets, including Asset, AssetType, and associated inputs and enums.
- [Asset groups](https://navixy.com/docs/navixy-repository-api/core-api-reference/assets/groups.md): Asset groups allow organizing assets into named collections for easier management, reporting, and access control.
- [Queries](https://navixy.com/docs/navixy-repository-api/core-api-reference/assets/groups/queries.md): Query reference for asset groups. List group types and groups with filtering, sorting, and membership history.
- [Mutations](https://navixy.com/docs/navixy-repository-api/core-api-reference/assets/groups/mutations.md): Mutation reference for asset groups. Create, update, and delete group types and groups, and manage asset memberships.
- [Types](https://navixy.com/docs/navixy-repository-api/core-api-reference/assets/groups/types.md): Type definitions for asset groups, including AssetGroupType, AssetGroup, membership types, and associated inputs and enums.
- [Geo objects](https://navixy.com/docs/navixy-repository-api/core-api-reference/geo-objects.md): Geo objects define geographic boundaries and points of interest, including geofences, routes, and landmarks used for location-based automation.
- [Queries](https://navixy.com/docs/navixy-repository-api/core-api-reference/geo-objects/queries.md): Query reference for geo objects. List and retrieve geo object types and geo objects with filtering, sorting, and pagination.
- [Mutations](https://navixy.com/docs/navixy-repository-api/core-api-reference/geo-objects/mutations.md): Mutation reference for geo objects. Create, update, and delete geo object types and geo objects.
- [Types](https://navixy.com/docs/navixy-repository-api/core-api-reference/geo-objects/types.md): Type definitions for geo objects, including GeoObjectType, GeoObject, geometry types, and associated inputs and enums.
- [Schedules](https://navixy.com/docs/navixy-repository-api/core-api-reference/schedules.md): Complete reference for schedules, including queries, mutations, and types for defining recurring time patterns such as working hours and maintenance windows (iCalendar-compatible).
- [Access control](https://navixy.com/docs/navixy-repository-api/core-api-reference/access-control.md): Role-based access control for your organization. Manage roles, assign permissions, and configure per-actor resource scopes.
- [Queries](https://navixy.com/docs/navixy-repository-api/core-api-reference/access-control/queries.md): Query reference for access control. List roles and retrieve permission and scope assignments for actors.
- [Mutations](https://navixy.com/docs/navixy-repository-api/core-api-reference/access-control/mutations.md): Mutation reference for access control. Assign and revoke roles, grant and revoke permissions, and set or remove user scopes.
- [Types](https://navixy.com/docs/navixy-repository-api/core-api-reference/access-control/types.md): Type definitions for access control, including Role, Permission, UserScope, and associated inputs and enums.
- [Custom fields](https://navixy.com/docs/navixy-repository-api/core-api-reference/custom-fields.md): Type definitions for custom field definitions, including field types, params, options, filter inputs, and the patch input used in asset and geo object mutations.
- [Audit](https://navixy.com/docs/navixy-repository-api/core-api-reference/audit.md): Query the audit trail to retrieve a paginated, filterable log of all create, update, and delete events across your organization.
- [Catalogs](https://navixy.com/docs/navixy-repository-api/core-api-reference/catalogs.md): Explains catalogs as Navixy Repository API reference data, including the CatalogItem interface, item origins, display metadata, and hierarchical items.
- [Catalog items](https://navixy.com/docs/navixy-repository-api/core-api-reference/catalogs/catalog-items.md): Queries, mutations, and types for catalog items, the configurable lookup entries used for device types, asset types, statuses, and other reference data.
- [Catalog reference](https://navixy.com/docs/navixy-repository-api/core-api-reference/catalogs/catalog-reference.md): Cross-reference of all catalog types organized by entity. Use this page to find which catalog backs a given field.
- [Tags](https://navixy.com/docs/navixy-repository-api/core-api-reference/catalogs/tags.md): Complete reference for tags. Create and manage flexible labels for classifying assets, geo objects, and other entities.
- [System catalogs](https://navixy.com/docs/navixy-repository-api/core-api-reference/catalogs/system.md): Predefined system catalog items available to all organizations. These read-only reference types cannot be modified or deleted.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/navixy-repository-api/core-api-reference.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.