Segments

Project-scoped targeting groups used in feature flags.

Definition

{
  "key": "enterprise-users",
  "name": "Enterprise Customers",
  "rules": [
    {
      "attribute": "plan",
      "operator": "equals",
      "values": ["enterprise"]
    }
  ],
  "included_keys": ["demo-user"],
  "excluded_keys": ["churned-user"]
}

Operators: equals, not_equals, contains, in_list, greater_than, less_than, matches_regex

Usage in Flags

{
  "key": "enterprise-feature",
  "targeting_rules": [{
    "operator": "in_segment",
    "values": ["enterprise-users"],
    "value": "true"
  }]
}

Segment evaluated when flag is evaluated.

Evaluation

POST /api/v1/projects/{slug}/segments/{key}/evaluate
{
  "context": {
    "user_id": "user123",
    "plan": "enterprise"
  }
}

Returns { "matched": true } or { "matched": false }.

API

GET    /api/v1/projects/{slug}/segments
POST   /api/v1/projects/{slug}/segments
GET    /api/v1/projects/{slug}/segments/{key}
PATCH  /api/v1/projects/{slug}/segments/{key}
DELETE /api/v1/projects/{slug}/segments/{key}

Limits

• Personal (Free): 5 segments
• Starter ($5/user): Unlimited segments