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

# Enrol Lead Finder

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

Enrol segments' EXISTING leads into one arm of a lead-finder experiment.

Deliberately not ``agent inject``: this writes ``ab_assignment`` and
nothing else — no search, no new leads, no re-rank, nothing that changes
which email goes out or when. It is how the instrument gets pointed at
live data before an experiment depends on the readout, and how an agent
drives an experiment without a button.

Write-scoped, and restricted to ``lead_finder`` experiments: the same
statement aimed at a visitor test would quietly rewrite a cohort somebody
is reading.

## Path parameters

- `key` string, required

## Headers

- `x-admin-token` string, nullable

## Request body

- LeadFinderEnrolBody
  - `segment_ids` integer[], required
  - `arm` string, required

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