← Ambasdr Docs
Frontend ↔ API Audit

Dashboard Data Audit

Every value rendered on the owner dashboard, mapped to the API field that supplies it. Confirms that no page shows fabricated data: everything numeric is either returned by an endpoint or derived from real fields, and unbacked areas are honest "coming soon" placeholders that display no invented numbers.

01

How to read this

Each page lists what it shows and where the value comes from. Verdicts:

✅ Real

Backed by the API

The value is a field returned by a real endpoint, or is computed in the frontend purely from real fields (counts, formatting, relative time).

⚠ Coming soon

No backend source yet

The area has no endpoint. It renders a placeholder that states the feature is coming — it never invents numbers. Consistent with the dashboard's graceful-states rule.

Premium gating. The knowledge graph (Home summary card and the Knowledge page) is Pro-only. Non-premium users see the summary/rest of the page but the graph itself is replaced by an upgrade prompt. Knowledge stats + graph are only fetched for premium users (useKnowledgeStats / useKnowledgeGraph receive no page id otherwise), so free users' Facts tile reads .

02

Home

Containers: useHomeDataGET /v1/me, /v1/pages, …/social-links, …/documents, …/conversations?limit=5, …/analytics, …/knowledge/stats, …/knowledge/graph.

ShownSourceVerdict
Identity bar — name, @handle, public URL, created date, avatarme.display_name / avatar_url / created_at, pages[0].slug
Conversations & Visitors tiles (Today / 7d / 30d toggle)GET …/analyticsconversations|visitors.{today,last_7_days,last_30_days}
Facts tile…/knowledge/stats.total_nodes (premium; for free)
Sources tileComputed: count of non-empty source categories
Your Summary text (N facts · M relationships · K sources)knowledge/stats.total_nodes / total_edges + source counts
Graph view…/knowledge/graph.nodes / edges — Pro-gated (upgrade prompt for free)
Recent conversations…/conversations (title, channel, message_count, created_at)
Feedback — most-asked topics, top referencesNo endpoint (conversation topic/reference analytics not built)
03

Knowledge (premium-only tab)

Container: useKnowledgeData. Free users get the full-page paywall before this view renders.

ShownSourceVerdict
Stat bar — Facts, Relationships, Last syncknowledge/stats.total_nodes / total_edges / last_ingested_at
Sources connectedComputed from real counts
Graph sectionknowledge/graph (premium; upgrade placeholder otherwise)
Sources catalog (files, socials, highlights, convos)documents / social-links / pages[0].highlights / conversations
Per-source "— facts" countNo per-source fact count in API (dash placeholder, not fabricated)
Recommendation banner copyStatic — recommendation pipeline not built
Strongest areas / Knowledge gaps / Visitor insightsNo endpoint — coming-soon placeholders
Activity timelineDerived from last_ingested_at / ingestion_status

knowledge/stats.entity_distribution (a type → count map) is returned by the API but currently unused. It could back "Strongest areas" and per-source fact counts without new backend work.

04

Agent · Files · Links

Fully backed — every displayed field maps to a real API field.

Page / ShownSourceVerdict
Agent — page purpose, promotion focus, save status…/agent-config.page_purpose / focus
Agent — "Agent brief" previewReflects the owner's own saved text (not a generated reply)
Files — filename, size, added date, processing status, Public/Private, context…/documents (filename, size_bytes, created_at, processing_status, visibility, is_published, context_text)
Links — social handles, custom links…/social-links (platform, label, url)
Links — link-in-bio preview (avatar, @handle, buttons)me + pages[0].slug + real links
05

Conversations

ShownSourceVerdict
List — channel, message count, time, "You" role…/conversations (channel, message_count, updated_at, visitor_role)
Transcript…/conversations/{id}.messages
Context panel — channel, role, count, started/last-activitySame record's real fields
"Topic & sentiment coming soon" noteStatic — analytics not built
06

Settings

SectionSourceVerdict
Account — name, username, avatarme + pages[0].slug; writes via PUT /v1/me, PUT /v1/pages/{id}, POST /v1/me/avatar
Subscription — plan tierme.plan_tier
Contact (phone), Notifications, SecurityNo endpoints — pending/coming-soon sections
Public Profile, LegalCross-links / static content (nav only)
07

Unbacked areas (all placeholders — no fabricated data)

These render honest "coming soon" copy. None display invented numbers. Listed here so future backend work has a checklist.

AreaWould need
Home — Feedback (topics, references)Conversation topic/reference analytics endpoint
Knowledge — Strongest areasPer-entity-type confidence (could derive from entity_distribution)
Knowledge — Knowledge gapsGap-detection analysis
Knowledge — Visitor insightsVisitor question analytics
Knowledge — per-source fact countsFacts-per-source rollup
Knowledge — recommendation banner copyRecommendation pipeline
Conversations — topics/sentimentPer-conversation topic + sentiment classification
Settings — Contact / Notifications / SecurityPhone capture, notification prefs, password/connected-accounts endpoints