Skip to content

Mobile Daily Snapshot API

itsDNNS edited this page Apr 30, 2026 · 1 revision

Mobile Daily Snapshot API

Use this page when building or evaluating a lightweight mobile client around Tribu's compact daily household snapshot.

What it is for

The mobile snapshot is meant to give a client the most useful household context without recreating the full desktop app:

  • upcoming events
  • open or due tasks
  • shopping context
  • birthdays
  • household summary data
  • small daily planning cues

Exact request and response schemas are available from your instance at /docs and /redoc.

When to use it

Use the snapshot when a mobile client needs a quick “what matters today?” view. Do not use it as a replacement for full module APIs when the client needs detailed editing flows.

Privacy expectations

The snapshot is household context. Treat it like normal Tribu data:

  • use authenticated requests only
  • do not log full responses in public support requests
  • redact names, private notes, dates, URLs, and household details from screenshots
  • do not expose tokens in mobile logs or crash reports

Client design guidance

Good mobile clients should:

  • show the next few relevant items, not the entire database
  • keep editing flows clear and scoped
  • handle empty states well
  • degrade gracefully when the network is unavailable
  • avoid caching sensitive data longer than necessary

Troubleshooting

Snapshot is empty

  • Confirm the authenticated user belongs to the selected family.
  • Add real calendar, task, shopping, or birthday data first.
  • Check the live API docs for required query parameters.

Mobile client sees stale data

  • Refresh the snapshot after mutating any module data.
  • Avoid long-lived client caches unless the UI clearly shows last refresh time.

Related pages

Clone this wiki locally