---
title: "Steps People"
method: POST
path: "/v1/ops/onboarding-funnel/steps/people"
tags: ["ops onboarding funnel"]
---

# Steps People

`POST /v1/ops/onboarding-funnel/steps/people`

## Request

- Base URL: `https://api.stormy.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stormy.ai/v1/ops/onboarding-funnel/steps/people`
- Auth: none declared

Who is behind one number: the people who reached a step, or stopped before it.

## Headers

- `authorization` string, nullable
- `x-darwin-token` string, nullable

## Request body

- FunnelPeopleAsk
  - `ask` FunnelAsk, required
    - `steps` StepAsk[], required
      - `event` string, required
      - `label` string
      - `filters` PropertyFilter[]
        - `key` string, required
        - `operator` 'exact' | 'is_not' | 'icontains' | 'not_icontains' | 'regex' | 'not_regex' | 'is_set' | 'is_not_set' | 'gt' | 'lt'
        - `value` string
        - `type` 'event' | 'person'
    - `date_from` string
    - `date_to` string, nullable
    - `viz` 'steps' | 'time_to_convert' | 'trends'
    - `order` 'ordered' | 'strict' | 'unordered'
    - `window` integer
    - `window_unit` 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month'
    - `count_by` 'people' | 'sessions'
    - `interval` 'hour' | 'day' | 'week' | 'month'
    - `breakdown` string, nullable
    - `breakdown_type` 'event' | 'person'
    - `compare` boolean
    - `filters` PropertyFilter[]
      - `key` string, required
      - `operator` 'exact' | 'is_not' | 'icontains' | 'not_icontains' | 'regex' | 'not_regex' | 'is_set' | 'is_not_set' | 'gt' | 'lt'
      - `value` string
      - `type` 'event' | 'person'
    - `environment` 'production' | 'all'
    - `include_ours` boolean
  - `step` integer, required
  - `dropped` boolean
  - `breakdown_value` unknown

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

## Changes

> 68 revisions in range; 1 not diffed.

- **2026-10-13** `f926858b5ed4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stormy/apis/stormy-control-plane/changes/v1/ops/onboarding-funnel/steps/people/post.md)

---

[API](https://skmtc.dev/stormy/apis/stormy-control-plane.md) · [All operations](https://skmtc.dev/stormy/apis/stormy-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/stormy/apis/stormy-control-plane/revisions/a40e83844eaa?raw)