Create Feature

Creates a new feature that can be used in plans and addons.

Mutation

Mutation

mutation CreateFeature($input: FeatureInput!) {
  createFeature(input: $input) {
    id
    refId
    displayName
    description
    featureType
    featureStatus
    featureUnits
    featureUnitsPlural
    hasMeter
    meterType
  }
}

{
  "input": {
    "refId": "feature-api-calls",
    "displayName": "API Calls",
    "description": "Number of API calls per month",
    "featureType": "NUMBER",
    "featureUnits": "call",
    "featureUnitsPlural": "calls",
    "environmentId": "env-123"
  }
}

{
  "data": {
    "createFeature": {
      "id": "feature-uuid-123",
      "refId": "feature-api-calls",
      "displayName": "API Calls",
      "description": "Number of API calls per month",
      "featureType": "NUMBER",
      "featureStatus": "PUBLISHED",
      "featureUnits": "call",
      "featureUnitsPlural": "calls",
      "hasMeter": false,
      "meterType": null
    }
  }
}

Parameters

input · FeatureInput · required

Input for creating a feature

Show properties

environmentId · UUID · required

Environment ID

displayName · String · required

Feature display name

featureType · FeatureType · required

BOOLEAN, NUMBER, or ENUM

refId · String

Unique feature reference ID

description · String

Feature description

featureUnits · String

Unit label (for NUMBER type)

featureUnitsPlural · String

Plural unit label

meterType · MeterType

Incremental or Fluctuating (for metered features)

enumConfiguration · [EnumConfigurationEntityInput]

Values for ENUM type features

additionalMetaData · JSON

Custom metadata

Feature Types

Type	Description	Example
BOOLEAN	On/off access	SSO, Advanced Reports
NUMBER	Quantity limits	API calls, Storage
ENUM	Tier-based access	Support level

Examples

Boolean Feature

{
  "input": {
    "refId": "feature-sso",
    "displayName": "Single Sign-On",
    "featureType": "BOOLEAN",
    "environmentId": "env-123"
  }
}

Numeric Feature with Meter

{
  "input": {
    "refId": "feature-storage",
    "displayName": "Storage",
    "featureType": "NUMBER",
    "featureUnits": "GB",
    "featureUnitsPlural": "GB",
    "meterType": "Fluctuating",
    "environmentId": "env-123"
  }
}

Enum Feature

{
  "input": {
    "refId": "feature-support",
    "displayName": "Support Level",
    "featureType": "ENUM",
    "enumConfiguration": [
      { "value": "basic", "displayName": "Basic Support" },
      { "value": "premium", "displayName": "Premium Support" },
      { "value": "enterprise", "displayName": "Enterprise Support" }
    ],
    "environmentId": "env-123"
  }
}

Related Operations

• Update Feature - Modify feature
• Archive Feature - Archive feature
• List Features - Query features