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

# Error and validation messages

What each message means and what to do about it. Messages are alphabetical.

### Messages

| Message                                                                                        | Where it appears                                         | What to do                                                                                                                    |
| ---------------------------------------------------------------------------------------------- | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| "Access denied to this customer. Your account may not have permission."                        | Customer Detail page                                     | Contact your administrator.                                                                                                   |
| "Access denied to this tenant."                                                                | Asset Detail actions                                     | Contact your administrator about your organization access.                                                                    |
| "An archived asset already uses this serial."                                                  | Duplicating an asset                                     | Keep the suggested serial number or edit it, then confirm.                                                                    |
| "An asset with this serial number already exists."                                             | New Asset wizard, or Asset Detail's Edit Asset Details   | Choose a different serial number.                                                                                             |
| "Authentication failed"                                                                        | Sign-in screen (fallback message)                        | Try again with Microsoft. Contact your administrator if it continues.                                                         |
| "Backend did not return accessToken"                                                           | Sign-in screen                                           | Try signing in again.                                                                                                         |
| "Brand, model code, and file are required."                                                    | Documents, Upload Model Manual                           | Fill in all three fields before uploading.                                                                                    |
| "Could not acquire Entra ID token for backend login"                                           | Sign-in screen                                           | Try signing in again.                                                                                                         |
| "Could not resolve email from Entra token"                                                     | Sign-in screen                                           | Try signing in again. Contact your administrator if it continues.                                                             |
| "Create organization endpoint not found. Expected POST /api/organizations."                    | Customers, New Customer form                             | Contact your Zephyr Intel contact. This is not something you can fix yourself.                                                |
| "Customer must be a tenant ID, not a name ("X"). Use tenant ID "Y"."                           | Bulk asset import                                        | Replace the customer name with the organization ID shown in the message.                                                      |
| "Customer not found: \<id>"                                                                    | Customer Detail page                                     | Check the link, or return to the customer list.                                                                               |
| "Document identifier is missing."                                                              | Documents, editing or deleting a document                | Reload the page and try again.                                                                                                |
| "Document name is required."                                                                   | Documents, Edit document dialog                          | Enter a name for the document.                                                                                                |
| "Endpoint only accepts POST requests"                                                          | Your browser, after repeatedly using Back during sign-in | This is a Microsoft sign-in message, not a Signal error. Close the tab and start signing in again from the Signal login page. |
| "Enter a baseline above $0"                                                                    | Products, Set Aftermarket Potential wizard               | Enter a dollar amount greater than zero.                                                                                      |
| "Enter a valid date."                                                                          | Asset Detail, Technical tab                              | Enter a date using the date field.                                                                                            |
| "Failed to add contact. Please try again."                                                     | Customers, Add Contact                                   | Try again.                                                                                                                    |
| "Failed to add facility. Please try again."                                                    | Customers, Add Facility or Add Office                    | Try again.                                                                                                                    |
| "Failed to add part"                                                                           | Asset Detail or Empire View, adding a BOM part           | Try again.                                                                                                                    |
| "Failed to add variant."                                                                       | Products, Add Variant                                    | Try again.                                                                                                                    |
| "Failed to apply potential"                                                                    | Products, Set Aftermarket Potential wizard               | Try again.                                                                                                                    |
| "Failed to change account type"                                                                | Customers, Change account type                           | Try again.                                                                                                                    |
| "Failed to create customer. Please try again."                                                 | Customers, New Customer form                             | Try again.                                                                                                                    |
| "Failed to create product line."                                                               | Products, Add Product Line                               | Try again.                                                                                                                    |
| "Failed to create technical bulletin. Please try again."                                       | Customers, Create Technical Bulletin                     | Try again.                                                                                                                    |
| "Failed to delete document."                                                                   | Documents, Delete document dialog                        | Try again.                                                                                                                    |
| "Failed to elevate products"                                                                   | Administration, Organization Admin                       | Try again.                                                                                                                    |
| "Failed to invite user. Please try again."                                                     | Customers, Portal tab                                    | Try again.                                                                                                                    |
| "Failed to load account owner options."                                                        | Customers, Edit Customer                                 | Reload the page and try again.                                                                                                |
| "Failed to load BOM"                                                                           | Asset Detail or Empire View, BOM modal                   | Reload the page and try again.                                                                                                |
| "Failed to load brands"                                                                        | Documents, Model Manuals tab                             | Reload the page and try again.                                                                                                |
| "Failed to load model manuals."                                                                | Documents, Model Manuals tab                             | Reload the page and try again.                                                                                                |
| "Failed to load users (HTTP \<status>)."                                                       | Administration, User Management                          | Try again. Contact support if it continues.                                                                                   |
| "Failed to read file."                                                                         | Uploading a customer logo                                | Try a different file.                                                                                                         |
| "Failed to remove alias. Please try again."                                                    | Customers, sales name aliases                            | Try again.                                                                                                                    |
| "Failed to remove technical bulletin. Please try again."                                       | Customers, Portal tab bulletins                          | Try again.                                                                                                                    |
| "Failed to remove user. Please try again."                                                     | Customers, Portal tab                                    | Try again.                                                                                                                    |
| "Failed to save the week"                                                                      | Visit Planning                                           | Try again. Your change may not have saved.                                                                                    |
| "Failed to save user"                                                                          | Administration, User Management                          | Try again.                                                                                                                    |
| "Failed to send invite. Please try again."                                                     | Customers, portal launch flow                            | Try again.                                                                                                                    |
| "Failed to unhost"                                                                             | Administration, Organization Admin hosts                 | Try again.                                                                                                                    |
| "Failed to update asset details."                                                              | Asset Detail, Edit Asset Details                         | Try again.                                                                                                                    |
| "Failed to update asset fields."                                                               | Asset Detail, Technical tab                              | Try again. The field keeps its previous value until it saves.                                                                 |
| "Failed to update contact. Please try again."                                                  | Customers, Edit Contact                                  | Try again.                                                                                                                    |
| "Failed to update customer. Please try again."                                                 | Customers, Edit Customer                                 | Try again.                                                                                                                    |
| "Failed to update document."                                                                   | Documents, Edit document dialog                          | Try again.                                                                                                                    |
| "Failed to update facility. Please try again."                                                 | Customers, Edit Facility                                 | Try again.                                                                                                                    |
| "Failed to update portal status."                                                              | Customers, Portal Settings                               | Try again.                                                                                                                    |
| "Failed to update status"                                                                      | Asset Detail or Empire View, Change Status dialog        | Try again.                                                                                                                    |
| "File is empty or has no data rows"                                                            | Any CSV or JSON import                                   | Add at least one data row and re-upload.                                                                                      |
| "File is too large."                                                                           | Uploading a document                                     | Upload a smaller file.                                                                                                        |
| "File too large. Max 2MB."                                                                     | Uploading a customer logo                                | Use an image file under 2MB.                                                                                                  |
| "Forbidden. You do not have upload permission."                                                | Uploading a document                                     | Ask your administrator for upload access.                                                                                     |
| "Identity provider token rejected (...)"                                                       | Sign-in screen                                           | Try signing in again. Contact your administrator if it continues.                                                             |
| "Install date cannot be in the future."                                                        | Asset Detail, Technical tab                              | Enter a date on or before today.                                                                                              |
| "Invalid JSON format"                                                                          | BOM import (JSON file)                                   | Check that the file is valid JSON and re-upload.                                                                              |
| "Item {n}: missing partNumber"                                                                 | BOM import (JSON file)                                   | Add a part number to that item and re-upload.                                                                                 |
| "JSON must be an array or an object with a "billOfMaterials" array"                            | BOM import (JSON file)                                   | Fix the file's structure and re-upload.                                                                                       |
| "Last maintenance cannot be before the install date."                                          | Asset Detail, Technical tab                              | Enter a date on or after the install date.                                                                                    |
| "Last maintenance cannot be in the future."                                                    | Asset Detail, Technical tab                              | Enter a date on or before today.                                                                                              |
| "Merge failed. Please try again."                                                              | Customers, Merge Customer dialog                         | Try again.                                                                                                                    |
| "Merge preview failed"                                                                         | Administration, Organization Admin merge                 | Try again.                                                                                                                    |
| "Missing required column: partNumber"                                                          | BOM import (CSV file)                                    | Add a partNumber column to your file and re-upload.                                                                           |
| "Missing required columns: ..."                                                                | Bulk asset import or Bulk BOM upload                     | Add the missing columns named in the message and re-upload.                                                                   |
| "Name and email are required."                                                                 | Customers, adding or inviting a portal user              | Fill in both fields.                                                                                                          |
| "No access to Signal for this action."                                                         | Asset Detail actions                                     | Contact your administrator; your account is missing Signal access.                                                            |
| "No matching rows found for selection"                                                         | Empire View, bulk Export CSV                             | Choose at least one row on the current page before exporting.                                                                 |
| "No organization id on this user — simulation cannot scope data."                              | Administration, simulating a user                        | Stop the simulation and choose a different user.                                                                              |
| "No valid BOM rows with Parent ID and Serial Number were found."                               | Empire View, Bulk BOM Upload                             | Check that your file has both columns filled in for at least one row.                                                         |
| "Part number is required"                                                                      | Asset Detail or Empire View, adding a BOM part           | Enter a part number.                                                                                                          |
| "Pop-up blocked. Allow pop-ups and try again."                                                 | Documents, "Open in new tab"                             | Allow pop-ups for Signal in your browser, then try again.                                                                     |
| "Remove serial numbers that do not belong to the selected customer."                           | Documents, Edit document or Upload dialog                | Remove the serials that don't belong to the chosen customer, or change the customer.                                          |
| "Row {n}: customer must be a tenant ID, not a name ("...")."                                   | Bulk asset import                                        | Replace the customer name in that row with its organization ID.                                                               |
| "Row {n}: missing partNumber"                                                                  | BOM import (CSV file)                                    | Fill in the part number for that row and re-upload.                                                                           |
| "Row {n}: missing required fields: ..."                                                        | Bulk asset import                                        | Fill in the missing fields for that row and re-upload.                                                                        |
| "Select a brand."                                                                              | Asset Detail, Technical tab                              | Choose a brand from the list.                                                                                                 |
| "Select a customer from the dropdown or clear the customer field."                             | Documents, Edit document or Upload dialog                | Pick a customer from the list, or clear the field.                                                                            |
| "Select an equipment type."                                                                    | Asset Detail, Technical tab                              | Choose an equipment type from the list.                                                                                       |
| "Select serial numbers from existing options, or clear the serial input."                      | Documents, Edit document or Upload dialog                | Pick from the suggested serial numbers, or clear the field.                                                                   |
| "Selected user has no organization id; cannot simulate scoped access."                         | Administration, User Management                          | Choose a different user to simulate.                                                                                          |
| "Session expired. Please sign in again."                                                       | Asset Detail actions                                     | Sign in again.                                                                                                                |
| "Signed-in identity does not match the account email. Try signing out and back in."            | Sign-in screen                                           | Sign out and sign back in with the matching account.                                                                          |
| "Too many files. Maximum 50 per batch."                                                        | Documents, Upload Documents                              | Upload files in smaller batches.                                                                                              |
| "Unable to download document."                                                                 | Documents                                                | Try again, or check your connection.                                                                                          |
| "Unable to open document."                                                                     | Documents                                                | Try again.                                                                                                                    |
| "Unable to open PDF preview."                                                                  | Documents                                                | Try downloading the document instead.                                                                                         |
| "Unauthorized. Please sign in again."                                                          | Uploading a document or BOM file                         | Sign in again.                                                                                                                |
| "Unknown customer tenant ID "X". Use a valid tenant ID from the customer list."                | Bulk asset import                                        | Look up the correct organization ID on the customer's page.                                                                   |
| "Unsupported file type."                                                                       | Uploading a document                                     | Use one of the accepted file types.                                                                                           |
| "Unsupported format. Use PNG, JPEG, GIF, SVG, or WebP."                                        | Uploading a customer logo                                | Use one of the accepted image formats.                                                                                        |
| "You do not have access to archive this asset."                                                | Asset Detail, Archive                                    | Ask your administrator for access.                                                                                            |
| "You do not have access to duplicate this asset."                                              | Asset Detail, Duplicate                                  | Ask your administrator for access.                                                                                            |
| "You do not have permission to edit this customer. Please ask an organization owner or admin." | Customers, Edit Customer                                 | Ask an organization owner or admin for access.                                                                                |
| "You do not have permission to edit this facility."                                            | Customers, Edit Facility                                 | Ask your administrator for access.                                                                                            |
| "Your account does not have access to Signal. Contact your administrator."                     | Sign-in screen                                           | Contact your administrator to request access.                                                                                 |
| "Your account is not provisioned for this environment. Ask an admin to invite you."            | Sign-in screen                                           | Ask your administrator to invite you.                                                                                         |
