Update feature

PUT

https://api.schematichq.com/features/:feature_id

PUT

/features/:feature_id

1 import { SchematicClient } from "@schematichq/schematic-typescript-node";
2 
3 async function main() {
4     const client = new SchematicClient({
5         apiKey: "YOUR_API_KEY_HERE",
6     });
7     await client.features.updateFeature("feature_id", {});
8 }
9 main();

1 {
2   "data": {
3     "created_at": "2024-01-15T09:30:00Z",
4     "description": "Enables the new user onboarding flow",
5     "feature_type": "boolean",
6     "flags": [
7       {
8         "created_at": "2024-01-15T09:30:00Z",
9         "default_value": false,
10         "description": "Flag to enable onboarding for beta users",
11         "flag_type": "boolean",
12         "id": "flag-123",
13         "key": "enable_onboarding_beta",
14         "name": "Enable Onboarding Beta",
15         "rules": [
16           {
17             "condition_groups": [
18               {
19                 "conditions": [
20                   {
21                     "condition_type": "equals",
22                     "created_at": "2024-01-15T09:30:00Z",
23                     "environment_id": "env-prod-123",
24                     "id": "cond-001",
25                     "operator": "greater_than",
26                     "resource_ids": [
27                       "res-001"
28                     ],
29                     "resources": [
30                       {
31                         "id": "res-001",
32                         "name": "Headquarters",
33                         "description": "Main office location",
34                         "image_url": "https://example.com/images/office.png"
35                       }
36                     ],
37                     "rule_id": "rule-001",
38                     "trait_value": "enterprise",
39                     "updated_at": "2024-04-01T12:00:00Z",
40                     "comparison_trait": {
41                       "created_at": "2023-12-01T08:00:00Z",
42                       "display_name": "Company Tier",
43                       "entity_type": "company",
44                       "hierarchy": [
45                         "business",
46                         "enterprise"
47                       ],
48                       "id": "trait-001",
49                       "trait_type": "string",
50                       "updated_at": "2024-01-10T10:00:00Z"
51                     },
52                     "comparison_trait_id": "trait-001",
53                     "condition_group_id": "cg-001",
54                     "event_subtype": "user_signup",
55                     "flag_id": "flag-123",
56                     "metric_period": "monthly",
57                     "metric_period_month_reset": "1",
58                     "metric_value": 100,
59                     "trait": {
60                       "created_at": "2023-12-01T08:00:00Z",
61                       "display_name": "Company Tier",
62                       "entity_type": "company",
63                       "hierarchy": [
64                         "business",
65                         "enterprise"
66                       ],
67                       "id": "trait-001",
68                       "trait_type": "string",
69                       "updated_at": "2024-01-10T10:00:00Z"
70                     },
71                     "trait_entity_type": "company",
72                     "trait_id": "trait-001"
73                   }
74                 ],
75                 "created_at": "2024-01-15T09:30:00Z",
76                 "environment_id": "env-prod-123",
77                 "id": "cg-001",
78                 "rule_id": "rule-001",
79                 "updated_at": "2024-04-01T12:00:00Z",
80                 "flag_id": "flag-123"
81               }
82             ],
83             "conditions": [
84               {
85                 "condition_type": "equals",
86                 "created_at": "2024-01-15T09:30:00Z",
87                 "environment_id": "env-prod-123",
88                 "id": "cond-002",
89                 "operator": "greater_than",
90                 "resource_ids": [
91                   "res-001"
92                 ],
93                 "resources": [
94                   {
95                     "id": "res-001",
96                     "name": "Headquarters",
97                     "description": "Main office location",
98                     "image_url": "https://example.com/images/office.png"
99                   }
100                 ],
101                 "rule_id": "rule-001",
102                 "trait_value": "enterprise",
103                 "updated_at": "2024-04-01T12:00:00Z",
104                 "comparison_trait": {
105                   "created_at": "2023-12-01T08:00:00Z",
106                   "display_name": "Company Tier",
107                   "entity_type": "company",
108                   "hierarchy": [
109                     "business",
110                     "enterprise"
111                   ],
112                   "id": "trait-001",
113                   "trait_type": "string",
114                   "updated_at": "2024-01-10T10:00:00Z"
115                 },
116                 "comparison_trait_id": "trait-001",
117                 "condition_group_id": "cg-001",
118                 "event_subtype": "user_signup",
119                 "flag_id": "flag-123",
120                 "metric_period": "monthly",
121                 "metric_period_month_reset": "1",
122                 "metric_value": 100,
123                 "trait": {
124                   "created_at": "2023-12-01T08:00:00Z",
125                   "display_name": "Company Tier",
126                   "entity_type": "company",
127                   "hierarchy": [
128                     "business",
129                     "enterprise"
130                   ],
131                   "id": "trait-001",
132                   "trait_type": "string",
133                   "updated_at": "2024-01-10T10:00:00Z"
134                 },
135                 "trait_entity_type": "company",
136                 "trait_id": "trait-001"
137               }
138             ],
139             "created_at": "2024-01-15T09:30:00Z",
140             "environment_id": "env-prod-123",
141             "id": "rule-001",
142             "name": "Enterprise Tier Rule",
143             "priority": 10,
144             "rule_type": "percentage_rollout",
145             "updated_at": "2024-04-01T12:00:00Z",
146             "value": true,
147             "flag_id": "flag-123"
148           }
149         ],
150         "updated_at": "2024-04-01T12:00:00Z",
151         "feature": {
152           "created_at": "2024-01-15T09:30:00Z",
153           "description": "Controls the onboarding feature rollout",
154           "feature_type": "boolean",
155           "icon": "onboarding_icon.png",
156           "id": "feat-001",
157           "name": "User Onboarding",
158           "updated_at": "2024-04-01T12:00:00Z",
159           "event_subtype": "user_signup",
160           "lifecycle_phase": "beta",
161           "maintainer_id": "maintainer-789",
162           "plural_name": "User Onboardings",
163           "singular_name": "User Onboarding",
164           "trait_id": "trait-456"
165         },
166         "feature_id": "feat-001",
167         "last_checked_at": "2024-04-20T16:00:00Z",
168         "maintainer_id": "maintainer-789"
169       }
170     ],
171     "icon": "onboarding_icon.png",
172     "id": "feat-001",
173     "name": "User Onboarding",
174     "plans": [
175       {
176         "id": "plan-001",
177         "name": "Enterprise",
178         "description": "Enterprise plan with advanced features",
179         "image_url": "https://example.com/images/enterprise_plan.png"
180       }
181     ],
182     "updated_at": "2024-04-01T12:00:00Z",
183     "event_subtype": "user_signup",
184     "event_summary": {
185       "company_count": 42,
186       "environment_id": "env-prod-123",
187       "event_count": 10500,
188       "event_subtype": "user_signup",
189       "user_count": 9800,
190       "last_seen_at": "2024-04-20T16:45:00Z"
191     },
192     "lifecycle_phase": "beta",
193     "maintainer_id": "maintainer-789",
194     "plural_name": "User Onboardings",
195     "singular_name": "User Onboarding",
196     "trait": {
197       "created_at": "2023-12-01T08:00:00Z",
198       "display_name": "Company Tier",
199       "entity_type": "company",
200       "hierarchy": [
201         "business",
202         "enterprise"
203       ],
204       "id": "trait-001",
205       "trait_type": "string",
206       "updated_at": "2024-01-10T10:00:00Z"
207     },
208     "trait_id": "trait-001"
209   },
210   "params": {}
211 }

Authentication

X-Schematic-Api-Keystring

API Key authentication via header

Path parameters

feature_idstringRequired

feature_id

Request

This endpoint expects an object.

descriptionstring or nullOptional<=1024 characters

event_subtypestring or nullOptional

feature_typeenum or nullOptional

Allowed values:

flagobjectOptional

iconstring or nullOptional

lifecycle_phaseenum or nullOptional

maintainer_idstring or nullOptional

namestring or nullOptional<=512 characters

plural_namestring or nullOptional

singular_namestring or nullOptional

trait_idstring or nullOptional

Response

dataobject

paramsobject

Input parameters

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error