Feature Flags

Feature flags allow you to enable or disable platform features per tenant. They are managed through the admin UI or API, and take effect immediately (cached for up to 5 minutes).

Available Feature Flags

Flag Key	Name	Description	Default
ui-entity-creation	Entity Creation UI	Enables entity creation via the UI (catalog page and explorer panel)	Enabled
ui-forge-molds	Forge Molds UI	Enables the Forge Molds UI for browsing and executing molds	Enabled

Managing Feature Flags

Admin UI

Navigate to Admin > Settings > Features (/admin/settings/features) to:

• View all feature flags and their current state
• Toggle the global default (enabled/disabled)
• Set per-tenant overrides

API

Get your enabled features:

curl -H "Authorization: Bearer $TOKEN" \
  https://your-domain/api/v1/me/features

Response:

{
  "features": {
    "ui-entity-creation": true,
    "ui-forge-molds": true
  }
}

List all flags (admin):

curl -H "Authorization: Bearer $TOKEN" \
  https://your-domain/api/v1/admin/features

Update a flag default (admin):

curl -X PUT -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"default_enabled": false}' \
  https://your-domain/api/v1/admin/features/ui-entity-creation

Set a per-tenant override (admin):

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}' \
  https://your-domain/api/v1/admin/features/ui-entity-creation/tenants/{tenantId}

Remove a per-tenant override (admin):

curl -X DELETE -H "Authorization: Bearer $TOKEN" \
  https://your-domain/api/v1/admin/features/ui-entity-creation/tenants/{tenantId}

How Feature Flags Work

Resolution Order

1. Check for a tenant-specific override (set via admin UI or API)
2. Fall back to the global default (from the feature flag definition)
3. If the flag doesn’t exist, it’s disabled

Caching

Feature flags are cached for 5 minutes per tenant. After changing a flag via the admin UI or API, it may take up to 5 minutes to take effect. Cache is automatically invalidated when:

• A flag’s global default is changed
• A tenant override is added or removed

Where Feature Flags Are Used

Flag	Location	What It Controls
ui-entity-creation	Catalog entities page, Explorer panel	”Create Entity” button visibility
ui-forge-molds	Forge section	Forge Molds navigation and page access