Create Feature

Creates a Feature in the catalog. The `key` is the stable application-facing identifier (e.g. 'custom_domain', 'workflows'); `type` decides how Prices grant the feature and how it resolves.

Authorization

AuthorizationRequiredBearer <token>

API key as Bearer token

In: header

Request Body

application/jsonRequired

keyRequiredstring

Application-facing identifier; lowercase, alphanumeric + underscore (e.g. 'custom_domain')

nameRequiredstring

typeRequiredstring

Feature value shape.

boolean: pure on/off
quantity: countable (drives Entitlement balance)
enum: one of a fixed ordered set of values
duration: number of days (or unlimited)

Value in: "boolean" | "quantity" | "enum" | "duration"

descriptionstring

enumValuesarray<string>

Required when type='enum'. Ordered low→high tier

metadataobject

POST/v1/features/

curl -X POST "https://api.3common.com/v1/features/" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "string",
    "name": "string",
    "type": "boolean",
    "description": "string",
    "enumValues": [
      "string"
    ],
    "metadata": {
      "property1": "string",
      "property2": "string"
    }
  }'

Default Response

Response

{
  "data": {
    "id": "string",
    "hostId": "string",
    "key": "string",
    "name": "string",
    "description": "string",
    "type": "boolean",
    "enumValues": [
      "string"
    ],
    "active": true,
    "metadata": {
      "property1": "string",
      "property2": "string"
    },
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  }
}

TypeScript

export interface Response {
  data: {
    id?: string;
    hostId?: string;
    /**
     * Application-facing identifier; unique per host
     */
    key?: string;
    name?: string;
    description?: string;
    /**
     * Feature value shape.
     * - boolean: pure on/off
     * - quantity: countable (drives Entitlement balance)
     * - enum: one of a fixed ordered set of values
     * - duration: number of days (or unlimited)
     */
    type?: "boolean" | "quantity" | "enum" | "duration";
    /**
     * Required for type=enum; ordered low→high
     */
    enumValues?: string[];
    active?: boolean;
    metadata?: {
      [k: string]: string;
    };
    createdAt?: string;
    updatedAt?: string;
  };
}