Create feature

POST

https://api.schematichq.com/features

POST

/features

1 import { SchematicClient } from "@schematichq/schematic-typescript-node";
2 
3 const client = new SchematicClient({ apiKey: "YOUR_API_KEY" });
4 await client.features.createFeature({
5     description: "description",
6     featureType: "boolean",
7     name: "name"
8 });

Try it

201Created

1 {
2   "data": {
3     "created_at": "2024-01-15T09:30:00Z",
4     "description": "Feature to enable dark mode in the application UI",
5     "feature_type": "boolean",
6     "flags": [
7       {
8         "created_at": "2024-01-15T09:30:00Z",
9         "default_value": false,
10         "description": "Flag to enable or disable dark mode",
11         "flag_type": "boolean",
12         "id": "flag-3456mnop",
13         "key": "dark_mode_enabled",
14         "name": "Enable Dark Mode",
15         "rules": [
16           {
17             "condition_groups": [
18               {
19                 "conditions": [
20                   {
21                     "condition_type": "subscription_check",
22                     "created_at": "2024-01-15T09:30:00Z",
23                     "environment_id": "env-prod-001",
24                     "id": "cond-1122aabb",
25                     "operator": "equals",
26                     "resource_ids": [
27                       "res-3344ccdd"
28                     ],
29                     "resources": [
30                       {
31                         "id": "res-3344ccdd",
32                         "name": "Premium Plan",
33                         "description": "Premium subscription plan",
34                         "image_url": "https://example.com/images/premium_plan.png"
35                       }
36                     ],
37                     "rule_id": "rule-5566eeff",
38                     "trait_value": "true",
39                     "updated_at": "2024-04-20T16:45:00Z",
40                     "comparison_trait": {
41                       "created_at": "2023-12-01T08:00:00Z",
42                       "display_name": "User Subscription Level",
43                       "entity_type": "company",
44                       "hierarchy": [
45                         "subscription",
46                         "tier"
47                       ],
48                       "id": "trait-9012ijkl",
49                       "trait_type": "boolean",
50                       "updated_at": "2024-01-10T10:00:00Z"
51                     },
52                     "comparison_trait_id": "trait-9012ijkl",
53                     "condition_group_id": "condgrp-7890qrst",
54                     "event_subtype": "ui_interaction",
55                     "flag_id": "flag-3456mnop",
56                     "metric_period": "monthly",
57                     "metric_period_month_reset": "1",
58                     "metric_value": 1,
59                     "trait": {
60                       "created_at": "2023-12-01T08:00:00Z",
61                       "display_name": "User Subscription Level",
62                       "entity_type": "company",
63                       "hierarchy": [
64                         "subscription",
65                         "tier"
66                       ],
67                       "id": "trait-9012ijkl",
68                       "trait_type": "boolean",
69                       "updated_at": "2024-01-10T10:00:00Z"
70                     },
71                     "trait_entity_type": "company",
72                     "trait_id": "trait-9012ijkl"
73                   }
74                 ],
75                 "created_at": "2024-01-15T09:30:00Z",
76                 "environment_id": "env-prod-001",
77                 "id": "condgrp-7890qrst",
78                 "rule_id": "rule-5566eeff",
79                 "updated_at": "2024-04-20T16:45:00Z",
80                 "flag_id": "flag-3456mnop"
81               }
82             ],
83             "conditions": [
84               {
85                 "condition_type": "subscription_check",
86                 "created_at": "2024-01-15T09:30:00Z",
87                 "environment_id": "env-prod-001",
88                 "id": "cond-1122aabb",
89                 "operator": "equals",
90                 "resource_ids": [
91                   "res-3344ccdd"
92                 ],
93                 "resources": [
94                   {
95                     "id": "res-3344ccdd",
96                     "name": "Premium Plan",
97                     "description": "Premium subscription plan",
98                     "image_url": "https://example.com/images/premium_plan.png"
99                   }
100                 ],
101                 "rule_id": "rule-5566eeff",
102                 "trait_value": "true",
103                 "updated_at": "2024-04-20T16:45:00Z",
104                 "comparison_trait": {
105                   "created_at": "2023-12-01T08:00:00Z",
106                   "display_name": "User Subscription Level",
107                   "entity_type": "company",
108                   "hierarchy": [
109                     "subscription",
110                     "tier"
111                   ],
112                   "id": "trait-9012ijkl",
113                   "trait_type": "boolean",
114                   "updated_at": "2024-01-10T10:00:00Z"
115                 },
116                 "comparison_trait_id": "trait-9012ijkl",
117                 "condition_group_id": "condgrp-7890qrst",
118                 "event_subtype": "ui_interaction",
119                 "flag_id": "flag-3456mnop",
120                 "metric_period": "monthly",
121                 "metric_period_month_reset": "1",
122                 "metric_value": 1,
123                 "trait": {
124                   "created_at": "2023-12-01T08:00:00Z",
125                   "display_name": "User Subscription Level",
126                   "entity_type": "company",
127                   "hierarchy": [
128                     "subscription",
129                     "tier"
130                   ],
131                   "id": "trait-9012ijkl",
132                   "trait_type": "boolean",
133                   "updated_at": "2024-01-10T10:00:00Z"
134                 },
135                 "trait_entity_type": "company",
136                 "trait_id": "trait-9012ijkl"
137               }
138             ],
139             "created_at": "2024-01-15T09:30:00Z",
140             "environment_id": "env-prod-001",
141             "id": "rule-5566eeff",
142             "name": "Enable for Premium Users",
143             "priority": 1,
144             "rule_type": "feature_flag",
145             "updated_at": "2024-04-20T16:45:00Z",
146             "value": true,
147             "flag_id": "flag-3456mnop"
148           }
149         ],
150         "updated_at": "2024-04-20T16:45:00Z",
151         "feature": {
152           "created_at": "2024-01-15T09:30:00Z",
153           "description": "Feature to enable dark mode in the application UI",
154           "feature_type": "boolean",
155           "icon": "moon",
156           "id": "feat-1234abcd",
157           "name": "Dark Mode Toggle",
158           "updated_at": "2024-04-20T16:45:00Z",
159           "event_subtype": "ui_interaction",
160           "lifecycle_phase": "beta",
161           "maintainer_id": "maintainer-5678efgh",
162           "plural_name": "Dark Mode Toggles",
163           "singular_name": "Dark Mode Toggle",
164           "trait_id": "trait-9012ijkl"
165         },
166         "feature_id": "feat-1234abcd",
167         "last_checked_at": "2024-04-20T16:45:00Z",
168         "maintainer_id": "maintainer-5678efgh"
169       }
170     ],
171     "icon": "moon",
172     "id": "feat-1234abcd",
173     "name": "Dark Mode Toggle",
174     "plans": [
175       {
176         "id": "plan-7890uvwx",
177         "name": "Premium Plan",
178         "description": "Premium subscription plan with advanced features",
179         "image_url": "https://example.com/images/premium_plan.png"
180       }
181     ],
182     "updated_at": "2024-04-20T16:45:00Z",
183     "event_subtype": "ui_interaction",
184     "event_summary": {
185       "company_count": 12,
186       "environment_id": "env-prod-001",
187       "event_count": 3450,
188       "event_subtype": "ui_interaction",
189       "user_count": 1200,
190       "last_seen_at": "2024-04-20T16:45:00Z"
191     },
192     "lifecycle_phase": "beta",
193     "maintainer_id": "maintainer-5678efgh",
194     "plural_name": "Dark Mode Toggles",
195     "singular_name": "Dark Mode Toggle",
196     "trait": {
197       "created_at": "2023-12-01T08:00:00Z",
198       "display_name": "User Subscription Level",
199       "entity_type": "company",
200       "hierarchy": [
201         "subscription",
202         "tier"
203       ],
204       "id": "trait-9012ijkl",
205       "trait_type": "boolean",
206       "updated_at": "2024-01-10T10:00:00Z"
207     },
208     "trait_id": "trait-9012ijkl"
209   },
210   "params": {}
211 }

Authentication

X-Schematic-Api-Keystring

API Key authentication via header

Request

This endpoint expects an object.

descriptionstringRequired<=1024 characters

feature_typeenumRequired

Allowed values:

namestringRequired<=512 characters

event_subtypestring or nullOptional

flagobjectOptional

iconstring or nullOptional

lifecycle_phaseenum or nullOptional

maintainer_idstring or nullOptional

plural_namestring or nullOptional

singular_namestring or nullOptional

trait_idstring or nullOptional

Response

Created

dataobject

paramsobject

Input parameters

Authentication

Request

Response

Errors