# My Nethesis API ## Description This is version `0.3.0` of this API documentation. Last update on Feb 4, 2026. REST API for My Nethesis with business hierarchy management and RBAC ## Servers - Backend API server (port 8080): https://api.your-domain.com/api (Backend API server (port 8080)) - Collect API server (port 8081): https://collect.your-domain.com/api (Collect API server (port 8081)) ## Authentication The API accepts 2 different authentication methods: - Basic auth (http) - Bearer auth (http) ## Endpoints and operations ### [Backend - Third-Party Applications](https://api.my.nethesis.it/group/endpoint-backend-third-party-applications.md) - [/third-party-applications - Get third-party applications](https://api.my.nethesis.it/operation/operation-getthirdpartyapplications.md) ### [Backend - Authentication](https://api.my.nethesis.it/group/endpoint-backend-authentication.md) - [/auth/exchange - Exchange Logto token for custom JWT](https://api.my.nethesis.it/operation/operation-exchangetoken.md) - [/auth/refresh - Refresh access token](https://api.my.nethesis.it/operation/operation-refreshtoken.md) - [/auth/logout - Logout user](https://api.my.nethesis.it/operation/operation-logout.md) ### [Backend - Me](https://api.my.nethesis.it/group/endpoint-backend-me.md) - [/me - Get current user information](https://api.my.nethesis.it/operation/operation-getme.md) - [/me/change-password - Change current user password](https://api.my.nethesis.it/operation/operation-changemypassword.md) - [/me/change-info - Change current user information](https://api.my.nethesis.it/operation/operation-changemyinfo.md) ### [Backend - Customers](https://api.my.nethesis.it/group/endpoint-backend-customers.md) - [/customers - List customers](https://api.my.nethesis.it/operation/operation-getcustomers.md) - [/customers - Create customer](https://api.my.nethesis.it/operation/operation-createcustomer.md) - [/customers/{id} - Get single customer](https://api.my.nethesis.it/operation/operation-getcustomerbyid.md) - [/customers/{id} - Update customer](https://api.my.nethesis.it/operation/operation-updatecustomer.md) - [/customers/{id} - Delete customer](https://api.my.nethesis.it/operation/operation-deletecustomer.md) - [/customers/{id}/stats - Get customer statistics](https://api.my.nethesis.it/operation/operation-getcustomerstats.md) - [/customers/{id}/suspend - Suspend customer](https://api.my.nethesis.it/operation/operation-suspendcustomer.md) - [/customers/{id}/reactivate - Reactivate customer](https://api.my.nethesis.it/operation/operation-reactivatecustomer.md) - [/customers/totals - Get customers totals](https://api.my.nethesis.it/operation/operation-getcustomerstotals.md) - [/customers/trend - Get customers trend data](https://api.my.nethesis.it/operation/operation-getcustomerstrend.md) - [/customers/export - Export customers to CSV or PDF](https://api.my.nethesis.it/operation/operation-exportcustomers.md) ### [Backend - Distributors](https://api.my.nethesis.it/group/endpoint-backend-distributors.md) - [/distributors - List distributors](https://api.my.nethesis.it/operation/operation-getdistributors.md) - [/distributors - Create distributor](https://api.my.nethesis.it/operation/operation-createdistributor.md) - [/distributors/{id} - Get single distributor](https://api.my.nethesis.it/operation/operation-getdistributorbyid.md) - [/distributors/{id} - Update distributor](https://api.my.nethesis.it/operation/operation-updatedistributor.md) - [/distributors/{id} - Delete distributor](https://api.my.nethesis.it/operation/operation-deletedistributor.md) - [/distributors/{id}/stats - Get distributor statistics](https://api.my.nethesis.it/operation/operation-getdistributorstats.md) - [/distributors/{id}/suspend - Suspend distributor](https://api.my.nethesis.it/operation/operation-suspenddistributor.md) - [/distributors/{id}/reactivate - Reactivate distributor](https://api.my.nethesis.it/operation/operation-reactivatedistributor.md) - [/distributors/totals - Get distributors totals](https://api.my.nethesis.it/operation/operation-getdistributorstotals.md) - [/distributors/trend - Get distributors trend data](https://api.my.nethesis.it/operation/operation-getdistributorstrend.md) - [/distributors/export - Export distributors to CSV or PDF](https://api.my.nethesis.it/operation/operation-exportdistributors.md) ### [Backend - Health](https://api.my.nethesis.it/group/endpoint-backend-health.md) - [/health - Health check](https://api.my.nethesis.it/operation/operation-gethealth.md) ### [Backend - Filters](https://api.my.nethesis.it/group/endpoint-backend-filters.md) - [/filters/systems/products - Get available product filters](https://api.my.nethesis.it/operation/operation-getfilterproducts.md) - [/filters/systems/created-by - Get available created-by filters](https://api.my.nethesis.it/operation/operation-getfiltercreatedby.md) - [/filters/systems/versions - Get version filters grouped by product](https://api.my.nethesis.it/operation/operation-getfilterversions.md) - [/filters/systems/organizations - Get available organization filters](https://api.my.nethesis.it/operation/operation-getfilterorganizations.md) - [/filters/applications/types - Get available application types](https://api.my.nethesis.it/operation/operation-getapplicationtypes.md) - [/filters/applications/versions - Get version filters grouped by application type](https://api.my.nethesis.it/operation/operation-getapplicationversions.md) - [/filters/applications/systems - Get available systems](https://api.my.nethesis.it/operation/operation-getapplicationsystems.md) - [/filters/applications/organizations - Get available organizations](https://api.my.nethesis.it/operation/operation-getapplicationorganizations.md) - [/filters/users/roles - Get available user roles for filtering](https://api.my.nethesis.it/operation/operation-getfilterusersroles.md) - [/filters/users/organizations - Get available organizations for filtering users](https://api.my.nethesis.it/operation/operation-getfilterusersorganizations.md) ### [Backend - Organizations](https://api.my.nethesis.it/group/endpoint-backend-organizations.md) - [/organizations - Get available organizations](https://api.my.nethesis.it/operation/operation-getorganizations.md) ### [Backend - Applications](https://api.my.nethesis.it/group/endpoint-backend-applications.md) - [/applications - List applications](https://api.my.nethesis.it/operation/operation-getapplications.md) - [/applications/totals - Get application statistics](https://api.my.nethesis.it/operation/operation-getapplicationtotals.md) - [/applications/trend - Get applications trend data](https://api.my.nethesis.it/operation/operation-getapplicationstrend.md) - [/applications/{id} - Get single application](https://api.my.nethesis.it/operation/operation-getapplicationbyid.md) - [/applications/{id} - Update application](https://api.my.nethesis.it/operation/operation-updateapplication.md) - [/applications/{id} - Delete application](https://api.my.nethesis.it/operation/operation-deleteapplication.md) - [/applications/{id}/assign - Assign organization](https://api.my.nethesis.it/operation/operation-assignapplicationorganization.md) - [/applications/{id}/unassign - Remove organization](https://api.my.nethesis.it/operation/operation-unassignapplicationorganization.md) ### [Backend - Resellers](https://api.my.nethesis.it/group/endpoint-backend-resellers.md) - [/resellers - List resellers](https://api.my.nethesis.it/operation/operation-getresellers.md) - [/resellers - Create reseller](https://api.my.nethesis.it/operation/operation-createreseller.md) - [/resellers/{id} - Get single reseller](https://api.my.nethesis.it/operation/operation-getresellerbyid.md) - [/resellers/{id} - Update reseller](https://api.my.nethesis.it/operation/operation-updatereseller.md) - [/resellers/{id} - Delete reseller](https://api.my.nethesis.it/operation/operation-deletereseller.md) - [/resellers/{id}/stats - Get reseller statistics](https://api.my.nethesis.it/operation/operation-getresellerstats.md) - [/resellers/{id}/suspend - Suspend reseller](https://api.my.nethesis.it/operation/operation-suspendreseller.md) - [/resellers/{id}/reactivate - Reactivate reseller](https://api.my.nethesis.it/operation/operation-reactivatereseller.md) - [/resellers/totals - Get resellers totals](https://api.my.nethesis.it/operation/operation-getresellerstotals.md) - [/resellers/trend - Get resellers trend data](https://api.my.nethesis.it/operation/operation-getresellerstrend.md) - [/resellers/export - Export resellers to CSV or PDF](https://api.my.nethesis.it/operation/operation-exportresellers.md) ### [Backend - Roles](https://api.my.nethesis.it/group/endpoint-backend-roles.md) - [/organization-roles - Get all organization roles](https://api.my.nethesis.it/operation/operation-getorganizationroles.md) - [/roles - Get all user roles](https://api.my.nethesis.it/operation/operation-getroles.md) ### [Backend - Systems](https://api.my.nethesis.it/group/endpoint-backend-systems.md) - [/systems - List systems](https://api.my.nethesis.it/operation/operation-getsystems.md) - [/systems - Create system](https://api.my.nethesis.it/operation/operation-createsystem.md) - [/systems/{id} - Get single system](https://api.my.nethesis.it/operation/operation-getsystembyid.md) - [/systems/{id} - Update system](https://api.my.nethesis.it/operation/operation-updatesystem.md) - [/systems/{id} - Delete system](https://api.my.nethesis.it/operation/operation-deletesystem.md) - [/systems/{id}/restore - Restore soft-deleted system](https://api.my.nethesis.it/operation/operation-restoresystem.md) - [/systems/{id}/suspend - Suspend system](https://api.my.nethesis.it/operation/operation-suspendsystem.md) - [/systems/{id}/reactivate - Reactivate suspended system](https://api.my.nethesis.it/operation/operation-reactivatesystem.md) - [/systems/{id}/regenerate-secret - Regenerate system secret](https://api.my.nethesis.it/operation/operation-regeneratesystemsecret.md) - [/systems/register - Register system with system_secret](https://api.my.nethesis.it/operation/operation-registersystem.md) - [/systems/totals - Get systems status summary](https://api.my.nethesis.it/operation/operation-getsystemstotals.md) - [/systems/trend - Get systems trend data](https://api.my.nethesis.it/operation/operation-getsystemstrend.md) - [/systems/export - Export systems to CSV or PDF](https://api.my.nethesis.it/operation/operation-exportsystems.md) - [/systems/{id}/inventory - Get system inventory history](https://api.my.nethesis.it/operation/operation-getsysteminventory.md) - [/systems/{id}/inventory/latest - Get latest system inventory](https://api.my.nethesis.it/operation/operation-getsysteminventorylatest.md) - [/systems/{id}/inventory/changes - Get inventory changes summary](https://api.my.nethesis.it/operation/operation-getsysteminventorychanges.md) - [/systems/{id}/inventory/changes/latest - Get latest inventory changes](https://api.my.nethesis.it/operation/operation-getsysteminventorychangeslatest.md) - [/systems/{id}/inventory/diffs - Get inventory diffs](https://api.my.nethesis.it/operation/operation-getsysteminventorydiffs.md) - [/systems/{id}/inventory/diffs/latest - Get latest inventory diff](https://api.my.nethesis.it/operation/operation-getsysteminventorydiffslatest.md) ### [Backend - User](https://api.my.nethesis.it/group/endpoint-backend-user.md) - [/user/permissions - Get user permissions (OAuth2/OIDC)](https://api.my.nethesis.it/operation/operation-getuserpermissions.md) - [/user/profile - Get user profile (OAuth2/OIDC)](https://api.my.nethesis.it/operation/operation-getuserprofile.md) ### [Backend - Users](https://api.my.nethesis.it/group/endpoint-backend-users.md) - [/users - List users](https://api.my.nethesis.it/operation/operation-getusers.md) - [/users - Create user](https://api.my.nethesis.it/operation/operation-createuser.md) - [/users/{id} - Get single user](https://api.my.nethesis.it/operation/operation-getuserbyid.md) - [/users/{id} - Update user](https://api.my.nethesis.it/operation/operation-updateuser.md) - [/users/{id} - Delete user](https://api.my.nethesis.it/operation/operation-deleteuser.md) - [/users/{id}/password - Reset user password](https://api.my.nethesis.it/operation/operation-resetuserpassword.md) - [/users/{id}/suspend - Suspend user](https://api.my.nethesis.it/operation/operation-suspenduser.md) - [/users/{id}/reactivate - Reactivate suspended user](https://api.my.nethesis.it/operation/operation-reactivateuser.md) - [/users/totals - Get users totals](https://api.my.nethesis.it/operation/operation-getuserstotals.md) - [/users/trend - Get users trend data](https://api.my.nethesis.it/operation/operation-getuserstrend.md) - [/users/export - Export users to CSV or PDF](https://api.my.nethesis.it/operation/operation-exportusers.md) ### [Backend - Validators](https://api.my.nethesis.it/group/endpoint-backend-validators.md) - [/validators/vat/{entity_type} - Validate VAT number](https://api.my.nethesis.it/operation/operation-validatevat.md) ### [Backend - Impersonation](https://api.my.nethesis.it/group/endpoint-backend-impersonation.md) - [/impersonate/consent - Get impersonation consent status](https://api.my.nethesis.it/operation/operation-getimpersonationconsentstatus.md) - [/impersonate/consent - Enable impersonation consent](https://api.my.nethesis.it/operation/operation-enableimpersonationconsent.md) - [/impersonate/consent - Disable impersonation consent](https://api.my.nethesis.it/operation/operation-disableimpersonationconsent.md) - [/impersonate - Start impersonation (permission-based access)](https://api.my.nethesis.it/operation/operation-impersonateuserwithconsent.md) - [/impersonate - Exit impersonation mode](https://api.my.nethesis.it/operation/operation-exitimpersonationwithaudit.md) - [/impersonate/status - Check current impersonation status](https://api.my.nethesis.it/operation/operation-getimpersonationstatus.md) - [/impersonate/sessions - List impersonation sessions](https://api.my.nethesis.it/operation/operation-getimpersonationsessions.md) - [/impersonate/sessions/{session_id} - Get details for specific session](https://api.my.nethesis.it/operation/operation-getimpersonationsession.md) - [/impersonate/sessions/{session_id}/audit - Get audit logs for specific session](https://api.my.nethesis.it/operation/operation-getsessionaudit.md) ### [Backend - Rebranding](https://api.my.nethesis.it/group/endpoint-backend-rebranding.md) - [List rebrandable products](https://api.my.nethesis.it/operation/operation-getrebrandingproducts.md) - [Enable rebranding for an organization](https://api.my.nethesis.it/operation/operation-enablerebranding.md) - [Disable rebranding for an organization](https://api.my.nethesis.it/operation/operation-disablerebranding.md) - [Get rebranding status for an organization](https://api.my.nethesis.it/operation/operation-getrebrandingstatus.md) - [Get rebranding products for an organization](https://api.my.nethesis.it/operation/operation-getrebrandingorgproducts.md) - [Upload rebranding assets for a product](https://api.my.nethesis.it/operation/operation-uploadrebrandingassets.md) - [Delete all rebranding assets for a product](https://api.my.nethesis.it/operation/operation-deleterebrandingproduct.md) - [Get a rebranding asset binary](https://api.my.nethesis.it/operation/operation-getrebrandingasset.md) - [Delete a single rebranding asset](https://api.my.nethesis.it/operation/operation-deleterebrandingasset.md) ### [Collect - Systems](https://api.my.nethesis.it/group/endpoint-collect-systems.md) - [/systems/info - Get system info](https://api.my.nethesis.it/operation/operation-getsysteminfo.md) - [/systems/inventory - Collect system inventory](https://api.my.nethesis.it/operation/operation-collectsysteminventory.md) - [/systems/heartbeat - System heartbeat](https://api.my.nethesis.it/operation/operation-sendsystemheartbeat.md) ### [Collect - Rebranding](https://api.my.nethesis.it/group/endpoint-collect-rebranding.md) - [Get system rebranding configuration](https://api.my.nethesis.it/operation/operation-getsystemrebranding.md) - [Get a rebranding asset binary for the system](https://api.my.nethesis.it/operation/operation-getsystemrebrandingasset.md) [Powered by Bump.sh](https://bump.sh)