Skip to main content
POST
Search subflows by filter criteria

Authorizations

Authorization
string
header
required

Use an Observe API key from the management console. The key selects the project and must grant the permission listed on the operation. Keep this key on your server.

Body

application/json
includeDetails
boolean

Include batched environment, error and tag details for userIDs, flowIDs or sessionIDs selectors. Filters retain their output setting.

userIDs
string[]

User IDs to fetch subflows for (format tus-<number>). Mutually exclusive with other selectors.

flowIDs
string[]

Flow IDs to fetch subflows for (format flw-<number>). Mutually exclusive with other selectors.

sessionIDs
string[]

Public session UUIDs to fetch subflows for. Mutually exclusive with other selectors.

filters
object

Time-window selector with optional narrowing filters. All narrowing filters are AND-combined; values within one filter are OR-combined. Filters targeting a column a subflow type does not have (e.g. cdaLikelihoods on anything but passkey-login) simply exclude that type from the result.

subFlowTypes
enum<string>[]

Optional subflow types to include.

Observe subflow type.

Available options:
passkeyLogin,
passwordLogin,
socialLogin,
provideIdentifier,
decision,
passkeyEnrollment,
emailOTP,
emailLink,
setPassword,
provideData,
reset,
passkeyDeletion,
smsOTP,
totp,
appConfirmation,
systemCredential,
trustedDeviceCheck,
trustedDeviceEnrollment,
keySigning,
keyRegistration
limit
integer
default:100

Maximum number of subflows to return in total across all subflow types. Defaults to 100, maximum 10000.

Required range: 1 <= x <= 10000

Response

Matching subflows.

subFlows
object[]
required

Matching subflows, capped at limit. ID-based selectors order oldest first; the filters selector orders newest first.

totalCount
integer<int64>

Total number of matching subflows before the limit cap. Only set for the filters selector — compare against the returned count to detect truncation (analytics over a truncated result cover the most recent totalCount-of-limit slice, not the whole window).

flowIDs
string[]

Deduplicated parent flow IDs (format flw-<number>) of the returned subflows, in result order. Only set for the filters selector. Store via POST /observe/idLists to hand the cohort to user-search or a funnel.

aggregates
object[]

Per-group counts of the matching subflows — only set for output=aggregate. Ordered by count descending and capped at 5000 cells (aggregateTruncated reports the cap firing; totalCount stays exact regardless). A value of "" means the dimension is not set on the subflow.

aggregateTruncated
boolean

True when the aggregate cell cap dropped long-tail groups.