SnozeDevelopers
API referenceAdmin

Update a platform experiment

Changes an experiment's status, variants, or targeting. Platform admins only; an unknown `experimentId` is reported as not found.

PATCH
/v1/admin/experiments/{experimentId}

Authorization

apiKey
headerAuthorizationBearer <snoze_sk_…>

Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.

Path Parameters

experimentId*string

Request Body

application/json
  1. body
status?|null
allocation?number|null
reason?string|null

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X PATCH 'https://api.snoze.dev/v1/admin/experiments/string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "data": {    "id": "string",    "name": "string",    "hypothesis": "string",    "targetType": "flag",    "targetKey": "string",    "assignmentUnit": "workspace",    "status": "draft",    "flagKey": "string",    "audience": "string",    "allocation": 0,    "primaryMetric": "string",    "guardrailMetric": "string",    "startedAt": "string",    "endsAt": "string",    "winner": "string",    "variants": [      {        "id": "string",        "label": "string",        "split": 0,        "exposures": 0,        "conversionRate": 0,        "errorRate": 0      }    ]  }}

Create a platform experiment

Registers an experiment with its variants and targeting, and returns the created record. Platform admins only; an invalid variant set or a duplicate key is rejected as a validation error.

List the audience segments

Returns the segments available for feature flag and experiment targeting. Platform admins only.