Flags API

Manage feature flags programmatically.

List Flags

GET /v1/flags

Response:

{
  "data": [
    {
      "id": "flag_123",
      "key": "new-checkout",
      "description": "New checkout flow",
      "enabled": true,
      "createdAt": "2024-01-15T10:00:00Z"
    }
  ]
}

Get Flag

GET /v1/flags/:key

Response:

{
  "data": {
    "id": "flag_123",
    "key": "new-checkout",
    "description": "New checkout flow",
    "enabled": true,
    "rules": [...],
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-20T15:30:00Z"
  }
}

Create Flag

POST /v1/flags

Request:

{
  "key": "new-checkout",
  "description": "New checkout flow",
  "enabled": false,
  "rules": [
    {
      "type": "percentage",
      "percentage": 10
    }
  ]
}

Update Flag

PATCH /v1/flags/:key

Request:

{
  "enabled": true,
  "rules": [
    {
      "type": "percentage",
      "percentage": 50
    }
  ]
}

Delete Flag

DELETE /v1/flags/:key

Evaluate Flag

POST /v1/flags/:key/evaluate

Request:

{
  "userId": "user-123",
  "attributes": {
    "plan": "pro",
    "country": "US"
  }
}

Response:

{
  "data": {
    "enabled": true,
    "reason": "rule_match"
  }
}