---
title: "Exclude Lead Finder Segments"
method: POST
path: "/api/experiments/{key}/lead-finder/exclude"
tags: ["Experiments"]
---

# Exclude Lead Finder Segments

`POST /api/experiments/{key}/lead-finder/exclude`

Take segments out of a RUNNING lead-finder experiment's answer.

Two modes, and the difference is whether the data survives:

* default — the segments stay on the page with their own numbers and leave
  the totals (the same treatment a frozen segment gets). Reversible: post
  an empty list to put them back.
* ``drop: true`` — their enrolment and lead assignments are deleted, and
  they disappear from the page entirely. Not reversible.

Why this is not ``DELETE …/enrol``: that one wipes the whole experiment and
refuses to run on a live card. Taking a few segments out of a live one is a
different operation with a real use — a test account whose budget got
zeroed leaves a cohort that can never send, and its zeros should not be
averaged into the answer while its ``found`` numbers stay worth reading.

## Path parameters

- `key` string, required

## Headers

- `x-admin-token` string, nullable

## Request body

- LeadFinderExcludeBody
  - `segment_ids` integer[], required
  - `drop` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/explee/apis/explee-api.md) · [All operations](https://skmtc.dev/explee/apis/explee-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/explee/explee-api/revisions/f169bc6e9447/schema)