Skip to main content
POST
Create experiment

Authorizations

Authorization
string
header
required

API key obtained from the Pictify dashboard

Body

application/json
name
string
required

Experiment name

Maximum string length: 255
Example:

"Homepage Hero A/B Test"

type
enum<string>
required

Experiment type

Available options:
ab_test,
smart_link,
scheduled
slug
string
required

URL-friendly identifier (3-60 chars)

Pattern: ^[a-z0-9][a-z0-9-]{1,58}[a-z0-9]$
Example:

"homepage-hero-test"

variants
object[]
required

Variants with weights summing to 10000

Minimum array length: 2
templateUid
string

Default template UID (optional if each variant has its own)

Example:

"tmpl_xyz789"

goalConfig
object
banditConfig
object
hypothesis
string
Maximum string length: 500
minimumSampleSize
integer
default:1000
confidenceThreshold
number
default:0.95
minimumRunDays
integer
default:7
outputConfig
object
fallbackImageUrl
string<uri>
fallbackTemplateUid
string

Response

Experiment created

experiment
object