API Reference

Flows

Multi-screen user journeys captured as ordered sequences.

A Flow is an ordered list of Screens representing a complete user journey — onboarding, checkout, paywall conversion, etc.

List flows

GET /api/v1/flows
NameTypeDescription
appIdstringFilter by app
typestringFlow type (onboarding, paywall, checkout, …)
platformIOS | ANDROID | WEBPlatform filter; lowercase URL tokens are accepted and normalized

Get a flow

GET /api/v1/flows/:id

Returns the flow plus its ordered list of screen objects (full payload, not just IDs).

Flow object

type Flow = {
  id: string
  appId: string
  type: string                   // 'onboarding'
  name: string                   // 'New user onboarding'
  description?: string
  screenIds: string[]            // ordered
  screens?: Screen[]             // present on GET /flows/:id
  capturedAt: string
}