Data & ingestion
My latest data isn't showing up
My latest data isn't showing up
Check the most recent ingestion run — its status and
logs tell you whether the import succeeded. Analytics (dashboards, KPIs, risk) reflect
the last successful ingestion.
An ingestion run failed
An ingestion run failed
Open the run and read its
Error-level logs and message. Common causes: the file
didn’t match a deployed ingestion spec, or a column
didn’t parse. Test the file in the sandbox before retrying.A spec doesn't pick up my file
A spec doesn't pick up my file
The file must satisfy the spec’s detection rules
(data source, filename pattern, header columns) and the spec must be deployed. Use
the sandbox to see which spec matches.
Alerts & signals
My alert isn't firing
My alert isn't firing
Alerts are tag-driven: they watch for entities carrying chosen tags. Make sure a
tagging rule actually tags the entities, that a
tag evaluation run has run, and that
the alert’s tags/perimeter match. See Alerts.
How do I alert on a metric threshold?
How do I alert on a metric threshold?
Create a tagging rule with a metric condition (e.g. days of stock ≤ 7) to tag the
matching items, then point an alert at that tag. See
Alerts overview.
Plans & approvals
I can't validate a plan — it asks for approval
I can't validate a plan — it asks for approval
The plan’s value crossed an approval policy
threshold. An approver (with the Plan approver permission) decides from the approvals
queue. See Plan lifecycle & approvals.
Adding an item is blocked
Adding an item is blocked
A business rule in Block mode rejected
it (e.g. a budget cap or supplier MOQ). The message names the rule; adjust the item or
the ruleset.
An approval disappeared / expired
An approval disappeared / expired
Approvals expire automatically when the plan changes after the request, so a stale
approval never applies. Re-validate to request a fresh one.
Risk & analytics
Risk or KPI figures look stale
Risk or KPI figures look stale
They’re computed over the latest ingested data — confirm a recent successful
ingestion run. See
Inventory risks.
A user sees fewer shops than expected
A user sees fewer shops than expected
Shop visibility depends on the role:
shops.viewAll vs shops.viewAssigned. See
Users, teams & roles.Access & API
A teammate can't see a section
A teammate can't see a section
Sections are gated by permissions and the org’s
navigation template. Check their role and the
assigned template.
My API call returns 401 vs 403
My API call returns 401 vs 403
401 means the token is missing, invalid, revoked, or expired — re-issue it. 403
means the token lacks the required permission — grant it (revoke + recreate, since
permissions are fixed at creation). See Error codes.I lost my API token value
I lost my API token value
The plaintext token is shown only once. If lost, revoke it and create a new one under
API tokens.
Didn’t find your answer? The AI Agent can often answer questions
about your own data directly.