Skip to main content
POST
Start an agent A/B experiment

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Path Parameters

id
string
required

Agent identifier (Devotel agent_xxx id).

Body

application/json
name
string
required

Human-readable experiment name.

Required string length: 1 - 200
variant_a_version_id
string
required

Prompt version id for the control arm (A).

variant_b_version_id
string
required

Prompt version id for the treatment arm (B). Must differ from A.

conversion_metric
enum<string>
required

The single outcome the experiment optimises for.

Available options:
reply_received,
goal_completion,
human_handoff_avoided
traffic_split_pct
integer
default:50

Percentage of new contacts routed to variant B (1–99, default 50).

Required range: 1 <= x <= 99

Response

201 - application/json

The started experiment

The started experiment

data
object
meta
object