List experiments
Experiments
Experiments
Manage A/B tests, smart links, and scheduled variants via API
GET
List experiments
Experiments
Create and manage experiments to test image variants. Supports A/B tests with Thompson Sampling, smart links with condition-based routing, and scheduled variants.For experiment types, lifecycle, and tracking details, see Experiments Concept.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /experiments/api | List experiments |
POST | /experiments/api | Create experiment |
GET | /experiments/api/{uid} | Get experiment |
PUT | /experiments/api/{uid} | Update experiment |
DELETE | /experiments/api/{uid} | Delete experiment |
POST | /experiments/api/{uid}/start | Start experiment |
POST | /experiments/api/{uid}/pause | Pause experiment |
POST | /experiments/api/{uid}/complete | Complete experiment |
GET | /experiments/api/quota | Check quota |
POST | /s/events | Track events |
GET | /s/{slug}/click | Click redirect |
GET | /s/{slug}/pixel.gif | Tracking pixel |
Editable Fields by Status
| Status | Editable Fields |
|---|---|
draft / paused | All fields |
running | name, confidenceThreshold, minimumRunDays, goalConfig.destinationUrl |
completed | name only |
Experiment Status
| Status | Description |
|---|---|
draft | Created but not started |
running | Actively serving variants and tracking events |
paused | Temporarily stopped, can be restarted |
completed | Finished with a declared winner |
archived | Soft-deleted |
Slug Requirements
| Rule | Details |
|---|---|
| Length | 3-60 characters |
| Format | Lowercase alphanumeric and hyphens |
| Pattern | Must start and end with alphanumeric |
| Uniqueness | Must be unique among active experiments |
| Reserved | events, api, admin, health, status, pixel, track, sdk |
Best Practices
- Use descriptive slugs that identify the test (e.g.,
email-banner-cta-test) - Start with a 50/50 split before enabling auto-optimization
- Set clear goals — use
click_throughwhen you want to measure engagement - Check your quota before creating experiments with
GET /experiments/api/quota - Always send a write key with event tracking to prevent data tampering
Authorizations
API key obtained from the Pictify dashboard
Query Parameters
Filter by experiment type
Available options:
ab_test, smart_link, scheduled Filter by status
Available options:
draft, running, paused, completed Page number
Required range:
x >= 1Number of results per page
Required range:
1 <= x <= 100