---
title: "Preview, then launch or pause the measured Buyer Agent test"
method: POST
path: "/api/v2/buyer-agent/experiment"
tags: ["Buyer Agent"]
---

# Preview, then launch or pause the measured Buyer Agent test

`POST /api/v2/buyer-agent/experiment`

## Request

- Base URL: `https://www.hireeli.io`
- URL: `https://www.hireeli.io/api/v2/buyer-agent/experiment`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Two steps. First call (no confirmation) returns 409 confirmation_required with the complete behavior, its preview hash and the required fields. Pausing (state paused) is then confirmed with literal user_confirmed true and confirmed_preview_hash. Starting a test, or changing who is in a running one (state live_test), changes what visitors see, so the first answer also carries visitor_test: every line of text a visitor can be shown, the pages, the button text and the share of visitors, with its own hash. Show the owner or admin that exact text first. The second call must then send literal user_confirmed true, confirmed_preview_hash and confirmed_proposal_hash (the visitor_test hash). A missing or changed hash answers 409 confirmation_stale with the current text and starts nothing. Starting requires an owner or admin; the confirmed rows are recorded as approved by that person in the same step. Readiness, billing, role and caps are rechecked on every call.

## Headers

- `x-eli-tenant` string, uuid

## Response `200`

Configuration receipt. For a start it includes proposal_hash, the hash of the text that was approved and started.

## Other responses

- `403`: Workspace, role, scope, plan or feature does not permit this operation.
- `409`: Confirmation required (with the preview and, for a start, visitor_test), confirmation stale (a hash is missing or the text changed), or not ready (nothing prepared, or the site tag is not seen).
- `429`: Request or durable protocol cap reached.
- `503`: A required security, billing, cap, audit, evidence or storage check is unavailable. Writes fail closed.

---

[API](https://skmtc.dev/hireeli/apis/eli-api.md) · [All operations](https://skmtc.dev/hireeli/apis/eli-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hireeli/apis/eli-api/revisions/3272729fecd2?raw)