Skip to navigation

Compare A/B variant performance

View as Markdown

Returns, for each live variant (oldest first), call volume, conversions, conversion rate with a 95% Wilson confidence interval, average duration and average sentiment. A call counts as a conversion when its outcome is a success outcome of any objective (for example a sale or a booked appointment). Only calls that received an outcome from post-call analysis are counted.

isSignificant only means the variant has at least 30 calls; it is not a statistical test between variants. Compare the confidence intervals: non-overlapping intervals indicate a real difference.

Returns an empty list when the agent has no variants or does not exist in the workspace.

Consistency. Cached for up to 30 seconds; variant writes through this API clear it immediately.

Access

  • Required scope: read.
  • Rate limit: General API — 120 (Starter), 200 (Growth), 300 (Business) or 600 (Enterprise) requests/min per workspace. See Rate limits.
  • Plan: Every plan includes A/B testing. It requires an active subscription (active, trialing or past_due); without one every A/B test operation, reads included, is refused with 403 BILLING_ERROR (metadata.kind: subscription_required).

Authentication

AuthorizationBearer

Workspace API key: jl_ followed by 64 lowercase hex characters, created by the workspace owner in the dashboard (Settings → API Keys) and sent as Authorization: Bearer jl_.... The plaintext is shown once, at creation; Jelliu stores only a SHA-256 hash. A workspace can hold up to 25 active keys.

ScopeGET / HEADPOST / PUT / PATCH / DELETEAdmin-only routes
readYesNoNo
writeYesYesNo
fullYesYesYes

Operations restricted to admins or owners reject keys without the full scope with 403, and say so in their description. No key, whatever its scope, can mint or revoke API keys or rotate a webhook secret — that requires a signed-in owner session. A revoked key stops authenticating within about 10 seconds. See Authentication.

Path parameters

agentIdstringRequiredformat: "uuid"

UUID of the agent. An unknown id or one from another workspace returns an empty list; a value that is not a UUID answers 400.

Response

Per-variant results, oldest first.

datalist of objects
One entry per live variant.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error