Retrieve the list of all devices from N-central for the logged-in user. Returns one page by default — set all: true to auto-paginate. Use format: "csv" for spreadsheet-ready output.

Retrieve a specific device by its ID. Note: lastLoggedInUser and stillLoggedIn fields may be null (known issue) — use list_devices to get these values instead.

Retrieve the status of service monitoring tasks for a given device.

Retrieve asset information for a device by ID. Note: Probes do not have assets and will return 404.

Retrieve asset lifecycle (warranty) information for a device by ID.

Retrieve the list of devices belonging to a specific organization unit. Returns one page by default — set all: true to auto-paginate. Use format: "csv" for spreadsheet-ready output.

Retrieve appliance-task information by task ID.

Add a new device to N-central. Required body fields: customerId, networkAddress, longName, supportedOs, deviceClass. Optional: description, licenseMode, macAddress, username, password.

Replace the asset lifecycle/warranty information for a device (PUT — all required fields must be provided).

Partially update asset lifecycle/warranty information for a device (PATCH — only provided fields are modified).

Retrieve a list of all organization units. Returns one page by default — set all: true to auto-paginate. Use format: "csv" for spreadsheet-ready output.

Retrieve a specific organization unit by ID.

Retrieve licensing/usage limits for an organization unit. Useful for capacity planning.

Update licensing/usage limits for an organization unit (PATCH — only provided fields modified).

Retrieve a list of all child organization units for a given org unit.

Retrieve a list of all service organizations. Returns one page by default — set all: true to auto-paginate. Use format: "csv" for spreadsheet-ready output.

Retrieve a specific service organization by ID.

Retrieve a list of customers. If soId is provided, returns only customers under that service organization; otherwise returns all customers. Returns one page by default — set all: true to auto-paginate. Use format: "csv" for spreadsheet-ready output.

Retrieve a specific customer by ID.

Retrieve a list of sites. If customerId is provided, returns only sites under that customer; otherwise returns all sites. Returns one page by default — set all: true to auto-paginate. Use format: "csv" for spreadsheet-ready output.

Retrieve a specific site by ID.

Create a new service organization. Required: contactFirstName, contactLastName, soName.

Create a new customer under a service organization. Required: contactFirstName, contactLastName, customerName.

Create a new site under a customer (PREVIEW endpoint — schema may change between N-central versions). Required: contactFirstName, contactLastName, siteName.

List all scheduled tasks across the N-central environment. Returns one page by default — set all: true to auto-paginate. Use format: "csv" for spreadsheet-ready output.

Retrieve general information for a given scheduled task by ID. Returns parent ID, name, type, customer ID, device IDs, and enabled status.

Retrieve status for a given scheduled task. Returns aggregated status by default; set detailed=true to get per-device status breakdown. WARNING: detailed=true does NOT accept DEVICE-level task IDs — only SYSTEM and CUSTOMER level. Use the parent task ID instead. Task hierarchy levels can be navigated via parentId.

Retrieve scheduled tasks for a specific device. Returns task ID, task name, and status. Returns one page by default — set all: true to auto-paginate. Use format: "csv" for spreadsheet-ready output.

Retrieve all custom properties for a specific device. Use format: "csv" for spreadsheet-ready output.

Retrieve a specific custom property for a device.

Retrieve the list of custom properties for an organization unit. Returns one page by default — set all: true to auto-paginate. Use format: "csv" for spreadsheet-ready output.

Retrieve a specific custom property for an organization unit.

Retrieve the default value for an organization unit custom property.

Retrieve the default device custom property information by organization unit ID and property ID.

Update a custom property value on a specific device. The N-central PUT endpoint requires propertyName and propertyType — pass the existing values (use get_device_custom_property if unsure). propertyType must match the property definition (HTML_LINK, TEXT, DATE, ENUMERATED, or PASSWORD).

Update a custom property value on an organization unit (SO, customer, or site). propertyType must match the property definition.

Update the default value of an org-unit custom property and optionally propagate the change down the org hierarchy. propagationType controls which levels receive the update.

Retrieve a global list of all users in N-central (not scoped by org unit). Returns one page by default — set all: true to auto-paginate. Use format: "csv" for spreadsheet-ready output.

Retrieve details for the currently authenticated user. Useful for "who am I" introspection.

Retrieve the list of users for a specific organization unit. Returns one page by default — set all: true to auto-paginate. Use format: "csv" for spreadsheet-ready output.

Retrieve a list of user roles for a given organization unit. Returns one page by default — set all: true to auto-paginate.

Retrieve a specific user role for a given organization unit and user role ID.

Retrieve access groups for a specific organization unit. Returns one page by default — set all: true to auto-paginate.

Retrieve detailed information for a specific access group by ID.

Create a new user role for an organization unit (PREVIEW endpoint). Required: roleName, description, permissionIds. Optional: userIds to assign the role to.

Create a new organization-unit-type access group. Required: groupName, groupDescription. Optional: orgUnitIds, userIds, autoIncludeNewOrgUnits.

Create a new device-type access group. Required: groupName, groupDescription. Optional: deviceIds, userIds.

Retrieve all notes attached to a specific device.

Add a note to a specific device. Required: text. The N-central API attaches the note to the authenticated user.

Add the same note to a list of devices in one call. Required: deviceIDs (numeric array), text.

Update an existing note on a device by note ID.

Retrieve all maintenance windows for a specific device.

Add a set of patch maintenance windows to a list of devices. Body shape: { deviceIDs: number[], maintenanceWindows: [...] }. See N-central API docs for MaintenanceWindowRequest field details. Note: partial failures are surfaced as per-device statuses in the response body — inspect carefully.

Modify existing device patch maintenance windows by their ScheduleId (included in each window object).

Retrieve the registration token for a site, organization unit, or customer.

Generate an activation key for a device by device ID.

Retrieve software installer download URLs for a specific customer. Supports filtering by software type and installer type.

Generate a software download link for a customer. Provide the softwareId obtained from get_software_installers.

Retrieve PSA (Professional Services Automation) customer mapping for a given customer ID.

Validate Standard PSA credentials for a given PSA type. Transmits credentials in the request body — use with care over untrusted transports. WARNING: per N-central documentation, this endpoint currently works only with TigerPaw 3.0, not other PSA integrations — calls for other PSAs will fail.

List Custom PSA tickets. Custom PSA only — managed PSA services are not supported by this endpoint.

Create a new Custom PSA ticket. Custom PSA only — operations for managed PSA services are not supported.

List all Standard PSA mappings for a customer.

Update Standard PSA mappings for a customer.

List Standard PSA companies associated with a customer.

List PSA company contacts for a customer.

List PSA company sites for a customer.

Retrieve detailed information for a specific Custom PSA ticket. Uses POST because the endpoint requires PSA credentials in the body.

Return N-central server information. Use level="health" for uptime/start time, level="extra" for system version details, or omit level (default) for API-service version info.

Retrieve the N-central server's current time. Useful for detecting clock drift between client and server.

Log out the current N-central API session, invalidating the access and refresh tokens. The next tool call will trigger a fresh JWT exchange.

Retrieve extra server version information using supplied credentials (for third-party system versions).

Retrieve the list of device filters. Returns one page by default — set all: true to auto-paginate.

Retrieve an N-central report by its report ID.

Fan out a per-device API call across all devices in an org unit. dataType selects which endpoint to call: "custom-properties", "assets" (probes return 404 and are skipped), or "monitor-status". Concurrency defaults are per-endpoint safe (3-5); override with concurrency. Returns CSV by default (set format: "json" to override).

List active issues for an organization unit. Returns CSV or JSON. KNOWN N-CENTRAL BUG: _extra.deviceClassValue and _extra.deviceClassLabel are always null. The underlying endpoint only supports customer/site org units, not service-orgs.

List job statuses for an organization unit. Returns CSV or JSON.

Generate a complete deduplicated user report for all customers under a service org. Fetches users from the SO itself and each customer concurrently, then deduplicates by userId. Returns CSV or JSON.

Generate a full device report for all devices under a specific service org. Fetches all devices and filters by soId field. Returns CSV or JSON.

Generate a summary report: all customers with their sites, device counts. Correlates data across customers, sites, and devices into one table. Returns CSV or JSON.

Generate a flat CSV/JSON of the full Service Org → Customer → Site hierarchy with IDs, names, contacts, and addresses. Returns CSV or JSON.

Submit a request to generate a patch comparison report. Required: startDate. Optional filters: installStatuses[], patchApprovals[], patchCategories[]. Returns a report ID (fetch via get_report).