Error handling for failed device exports

N-central provides clear error messages and convenient tools to help you diagnose and resolve export issues quickly. When an export fails, use the following features and tips:

Error messages

The Last failure timestamp column shows when the error occurred, and the Last error message column explains the reason for the failure.

Common error types and troubleshooting tips:

• 400 Validation errors

  • Cause: Required fields are missing (for example, “Device serial number missing”).

  • Fix: Check the device details in N-central and ensure all mandatory fields are populated before retrying the export.

• 401 Unauthorized errors

  • Cause: Invalid API credentials.

  • Fix: Verify the Client ID and Client Secret entered in N-central match the values generated in HaloPSA. Regenerate the Client Secret if necessary.

• 429 Rate limit errors

  • Cause: Too many export requests were triggered in a short time.

  • Fix: Wait for the retry window indicated in the error message before attempting another export. Review automation settings to avoid excessive triggers.

View and download error details

To make troubleshooting easier, N-central provides quick actions for failed exports:

• Filter failed exports – Select the Failed exports filter to show only rows with failed device exports.

• View full error messages – Long messages in the Export results table are truncated with an ellipsis (…) for a cleaner view. Hover over a truncated message to see the full text in a tooltip.

• Copy or download error details – Use the quick-action icons next to each error message:

  • Copy to clipboard – Instantly copies the full error text for troubleshooting or sharing.

  • Download as text file – Saves the full error message, including device details and timestamp, as a .txt file for easy reference or support tickets.

Currently, errors can only be copied or downloaded one at a time. Bulk copy or download is not supported.