Skip to main content
PUT
Split new conversations between the base and the variants

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

cloudchat-instance
string
required

The CloudChat instance the account lives in, e.g. 4. Sent as a header, and required: with accountId it forms the pair that names exactly one account, which accountId alone does not. listMyCloudChatAccounts returns the value to send here alongside each accountId.

Path Parameters

project
string
required

The ClaudIA project to act on, by name. Get the names from listMyClaudiaProjects — a project these credentials do not cover answers 404, indistinguishable from one that does not exist.

Query Parameters

accountId
string
required

The CloudChat account whose permissions decide what you may read and write here, e.g. 7. It is permission context, not the resource: the project is named in the path. Only unique within an instance, so it is always read together with the cloudchat-instance header — get the pair from listMyCloudChatAccounts. An account your credentials hold no editing claim for answers 403.

Body

application/json

The whole traffic split, sent at once. A variant left out receives no traffic.

percentages
object
required

Percent of new conversations for each variant, by key. Each between 0 and 100, summing to at most 100.

Example:
baselinePercentage
integer<int32>

What you expect to stay on the base configuration: 100 minus the sum of percentages. It is checked, not applied — a different number is refused with the right one and nothing is saved.

Example:

80

Response

Saved. The whole A/B test is returned as it now stands.

How this project's conversations are split between its base configuration and each A/B variant. Every new conversation draws once and keeps the variant it drew until it ends, always running that variant's current settings.

baselinePercentage
integer<int32>
required

Share of new conversations that run the base configuration, in percent.

Example:

80

variants
object[]
required

Every variant this project declares, including the ones receiving no traffic.