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

# Steps

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

## 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`
- Auth: none declared

The funnel for these steps: per step reached, converted, dropped and time to convert.

## Query parameters

- `refresh` boolean

## Headers

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

## Request body

- FunnelAsk
  - `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

## 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/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)