Segments

{
  "data": [
    {
      "id": "seg_001",
      "tenantId": "tenant_001",
      "name": "high_value_customers",
      "description": "Customers with lifetime value > $10,000",
      "status": "active",
      "entityType": "customer",
      "baseSchemaId": "schema_001",
      "baseSchema": { "name": "customers" },
      "baseSchemaName": "customers",
      "customerCount": 4521,
      "joins": [],
      "filters": [{ "field": "lifetime_value", "operator": ">", "value": 10000 }],
      "viewName": "seg_a1b2c3d4e5f6",
      "lastRefreshedAt": null,
      "createdAt": "2026-02-01T10:00:00.000Z",
      "updatedAt": "2026-02-01T10:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 8,
    "hasMore": false,
    "limit": 50,
    "cursor": null
  }
}

curl -X POST https://playground.kaireonai.com/api/v1/segments \
  -H "Content-Type: application/json" \
  -H "X-Tenant-Id: my-tenant" \
  -d '{
    "name": "high_value_customers",
    "baseSchemaId": "schema_001",
    "description": "Customers with lifetime value > $10,000",
    "status": "active",
    "filters": [
      { "field": "lifetime_value", "operator": ">", "value": 10000 }
    ]
  }'

{
  "rows": [
    { "id": "CUST001", "email": "john@example.com", "lifetime_value": 15200.50 }
  ],
  "count": 20
}