Runtime API

Creates an anonymous visitor id for rollout and experiment consistency. The id is not stored by the API.

{
  "visitorId": "vis_4f8a1b2c3d4e5f6a7b8c9d0e"
}

Authenticates with an application API key, resolves an environment, loads the flag configuration, applies rollout and rules, then returns the resolved value.

POST /flags/my-feature/evaluate
X-API-Key: <application-api-key>
X-Hostname: app.example.com
X-Visitor-ID: vis_4f8a1b2c

{
  "groups": ["beta-testers"],
  "attributes": { "plan": "premium" }
}

{
  "key": "my-feature",
  "enabled": true,
  "value": true,
  "variant": "treatment"
}

Authenticates with an application API key and records a named conversion for the resolved environment, visitor, and optional authenticated user.

POST /events/checkout-completed
X-API-Key: <application-api-key>
X-Hostname: app.example.com
X-Visitor-ID: vis_4f8a1b2c

{
  "metadata": { "source": "web" }
}

{
  "event": "checkout-completed",
  "recordedAt": "2026-09-01T10:30:00.000Z"
}