Skip to main content

Troubleshooting

Login & Authentication​

"Unable to log in" or blank screen after login​

  • Clear your browser cache and cookies, then try again
  • Ensure you're using a supported browser (Chrome, Firefox, Safari, Edge)
  • Check that your organization's Auth0 domain is reachable
  • If using the mobile app, try force-closing and reopening the app

Session expired​

Auth0 sessions expire after a period of inactivity. You'll be prompted to log in again. On mobile, enable biometric authentication in Settings for faster re-login.

"Unauthorized" error on API calls​

Your access token has expired. Refresh the page (web) or reopen the app (mobile). If the issue persists, log out and log back in.

Assets​

Asset not appearing in the tree view​

  • Check that the asset has a parent assigned — orphaned assets without a parent may not appear in the tree
  • Verify the asset is not archived — use the status filter to show archived assets
  • The tree view loads children on-demand — expand the parent node to reveal children

Custom data fields not showing​

Custom fields are defined by the resource type. If you don't see expected fields:

  1. Go to Settings → Asset Types
  2. Find your resource type and verify the schema includes the expected fields
  3. If the type was recently updated, refresh the asset detail page

Location not updating​

  • Edge devices: Check device connectivity in the Health dashboard. The device may be offline or have low battery
  • Integration devices (Garmin, etc.): Verify the integration is connected in Settings → Integrations
  • Manual locations: These are set once and don't auto-update

Inventory​

Stock mutation says "duplicate request"​

All stock mutations use idempotency keys to prevent double-processing. If you see this error, the operation was already completed. Refresh the stock list to see the updated quantities.

Serial number not found​

  • Serial numbers follow the format SN-YYYY-NNNN (auto-generated) or your custom prefix
  • Check the serial status — SCRAPPED serials cannot be used in further operations
  • Verify the part's tracking mode is set to Serialized or Asset (not Quantity)

Transfer shows "cross-site" warning​

This is informational, not an error. Transfers between different warehouses/sites are allowed but flagged so you can verify the destination is correct.

Work Orders​

Cannot approve a work order​

  • Only Admin users can approve work orders
  • The work order must be in Awaiting Approval status
  • Check that you're viewing the correct work order (verify the WO-YYYY-NNNN number)

Hold or Cancel button requires a reason​

This is by design. When placing a work order on hold or cancelling it, you must provide a reason in the reason field. This is recorded in the audit history.

PM schedule not generating work orders​

  • Verify the PM schedule is active (not disabled)
  • Check the recurrence settings — time-based (daily/weekly/monthly/yearly) or meter-based
  • Meter-based schedules require meter readings to trigger

Fleet Map​

No devices shown on the map​

  • Verify your assets have edge devices (ka1, ka1-co, mesa) or integration devices (Garmin) assigned
  • Check device connectivity in the Health dashboard
  • Ensure devices have reported at least one GNSS location

Weather overlay not showing​

  1. Go to Settings → Weather
  2. Verify the weather overlay is enabled
  3. Check that you've drawn a bounding box and selected at least one parameter
  4. Weather tiles refresh every 6 hours with GFS model cycles — check the status for the latest available cycle

AI Assistant (Thyra)​

Voice input not working​

  • Grant microphone permission when prompted by the browser
  • Use Chrome or Safari — some browsers don't support the MediaRecorder API
  • The recording auto-stops at 60 seconds
  • Check that your device has a working microphone

Image upload fails​

  • Maximum file size is 4 MiB
  • Supported formats: JPEG, PNG, WebP, GIF
  • The image is sent to Claude for analysis — very large or corrupted images may fail

Thyra won't create/update resources​

All write operations (create asset, create work order, consume inventory) require explicit confirmation. Click the "Confirm" button in the action preview to execute.

Mobile App​

QR/NFC scan not finding the asset​

  • Ensure the QR code or NFC tag has been assigned to an asset (via the asset's External IDs section)
  • For NFC, hold the phone close to the tag for 2-3 seconds
  • Check that camera permissions are granted (for QR scanning)

Offline changes not syncing​

  • Verify you have an active internet connection
  • Open the app and wait for the sync indicator to complete
  • If sync fails, the changes are retained locally — try again when you have a stable connection

Push notifications not received​

  1. Go to More → Notification Preferences
  2. Verify the desired categories are enabled
  3. Check your device's notification settings for the Powoflow app
  4. Ensure the app has been granted notification permissions

Browser Compatibility​

BrowserMinimum VersionNotes
Chrome90+Recommended
Firefox90+Full support
Safari15+Full support
Edge90+Full support

Getting Help​

If your issue isn't covered here:

  • Contact your organization's Powoflow administrator
  • Check the API documentation for endpoint-specific error codes
  • Review the Activity Log in Settings for recent changes that may have caused the issue