Partially update a feature
Deprecated. Use POST /v2/features/:id instead.
Updates the Feature Flag and immediately publishes a new revision. The caller needs Edit access in the Feature Flag’s Project and Publish access for every affected environment. When approval is required, use the revision endpoints instead, unless the caller can bypass draft approvals.
curl -X POST 'https://api.growthbook.io/api/v1/features/{id}' \
-H 'Authorization: Bearer YOUR_API_KEY'import requests
url = "https://api.growthbook.io/api/v1/features/{id}"
payload = {
"description": "<string>",
"archived": True,
"project": "<string>",
"targetingAllProjects": True,
"targetingProjects": ["<string>"],
"owner": "<string>",
"defaultValue": "<string>",
"baseConfig": "<string>",
"tags": ["<string>"],
"environments": {},
"prerequisites": ["<string>"],
"jsonSchema": "<string>",
"customFields": {},
"holdout": {
"id": "<string>",
"value": "<string>"
},
"comment": "<string>",
"ignoreWarnings": True,
"skipSchemaValidation": True,
"skipHooks": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
description: '<string>',
archived: true,
project: '<string>',
targetingAllProjects: true,
targetingProjects: ['<string>'],
owner: '<string>',
defaultValue: '<string>',
baseConfig: '<string>',
tags: ['<string>'],
environments: {},
prerequisites: ['<string>'],
jsonSchema: '<string>',
customFields: {},
holdout: {id: '<string>', value: '<string>'},
comment: '<string>',
ignoreWarnings: true,
skipSchemaValidation: true,
skipHooks: true
})
};
fetch('https://api.growthbook.io/api/v1/features/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.growthbook.io/api/v1/features/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'description' => '<string>',
'archived' => true,
'project' => '<string>',
'targetingAllProjects' => true,
'targetingProjects' => [
'<string>'
],
'owner' => '<string>',
'defaultValue' => '<string>',
'baseConfig' => '<string>',
'tags' => [
'<string>'
],
'environments' => [
],
'prerequisites' => [
'<string>'
],
'jsonSchema' => '<string>',
'customFields' => [
],
'holdout' => [
'id' => '<string>',
'value' => '<string>'
],
'comment' => '<string>',
'ignoreWarnings' => true,
'skipSchemaValidation' => true,
'skipHooks' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.growthbook.io/api/v1/features/{id}"
payload := strings.NewReader("{\n \"description\": \"<string>\",\n \"archived\": true,\n \"project\": \"<string>\",\n \"targetingAllProjects\": true,\n \"targetingProjects\": [\n \"<string>\"\n ],\n \"owner\": \"<string>\",\n \"defaultValue\": \"<string>\",\n \"baseConfig\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"environments\": {},\n \"prerequisites\": [\n \"<string>\"\n ],\n \"jsonSchema\": \"<string>\",\n \"customFields\": {},\n \"holdout\": {\n \"id\": \"<string>\",\n \"value\": \"<string>\"\n },\n \"comment\": \"<string>\",\n \"ignoreWarnings\": true,\n \"skipSchemaValidation\": true,\n \"skipHooks\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.growthbook.io/api/v1/features/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"description\": \"<string>\",\n \"archived\": true,\n \"project\": \"<string>\",\n \"targetingAllProjects\": true,\n \"targetingProjects\": [\n \"<string>\"\n ],\n \"owner\": \"<string>\",\n \"defaultValue\": \"<string>\",\n \"baseConfig\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"environments\": {},\n \"prerequisites\": [\n \"<string>\"\n ],\n \"jsonSchema\": \"<string>\",\n \"customFields\": {},\n \"holdout\": {\n \"id\": \"<string>\",\n \"value\": \"<string>\"\n },\n \"comment\": \"<string>\",\n \"ignoreWarnings\": true,\n \"skipSchemaValidation\": true,\n \"skipHooks\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.growthbook.io/api/v1/features/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"description\": \"<string>\",\n \"archived\": true,\n \"project\": \"<string>\",\n \"targetingAllProjects\": true,\n \"targetingProjects\": [\n \"<string>\"\n ],\n \"owner\": \"<string>\",\n \"defaultValue\": \"<string>\",\n \"baseConfig\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"environments\": {},\n \"prerequisites\": [\n \"<string>\"\n ],\n \"jsonSchema\": \"<string>\",\n \"customFields\": {},\n \"holdout\": {\n \"id\": \"<string>\",\n \"value\": \"<string>\"\n },\n \"comment\": \"<string>\",\n \"ignoreWarnings\": true,\n \"skipSchemaValidation\": true,\n \"skipHooks\": true\n}"
response = http.request(request)
puts response.read_body{
"feature": {
"id": "<string>",
"dateCreated": "2023-11-07T05:31:56Z",
"dateUpdated": "2023-11-07T05:31:56Z",
"archived": true,
"description": "<string>",
"owner": "<string>",
"project": "<string>",
"valueType": "boolean",
"defaultValue": "<string>",
"tags": [
"<string>"
],
"environments": {},
"revision": {
"version": 123,
"comment": "<string>",
"date": "2023-11-07T05:31:56Z",
"createdBy": "<string>",
"publishedBy": "<string>",
"id": "<string>"
},
"ownerEmail": "<string>",
"targetingAllProjects": true,
"targetingProjects": [
"<string>"
],
"baseConfig": "<string>",
"defaultValueConfig": "<string>",
"prerequisites": [
"<string>"
],
"customFields": {},
"holdout": {
"id": "<string>",
"value": "<string>"
}
},
"bypassedGates": [
{
"type": "<string>",
"outcome": "bypassed",
"via": "ignoreWarnings"
}
]
}{
"confirmation": {
"id": "<string>",
"status": "pending",
"actions": [
{
"action": "feature.create",
"environments": [
"<string>"
]
}
],
"summary": "<string>",
"url": "<string>",
"expiresAt": "<string>",
"response": {
"status": 123,
"body": "<unknown>"
},
"note": "<string>"
},
"message": "<string>"
}Authorizations
Pass your API key as the Bearer token. See Authentication.
Body
Set to true to acknowledge the warnings listed in a blocked response and continue. This covers experiment guards, locked dependents, and references affected by an archive. When the organization treats schema failures as warnings, it also covers schema and invariant warnings. It never bypasses a rejected Custom Hook. On revision publish endpoints, it can also force-publish an out-of-date draft when the caller has Bypass draft approvals access. Only set this when a person has explicitly asked you to. If a check blocks you, stop and ask a person instead of working around it.
Set to true to publish despite schema validation errors, failed invariants, or schema changes that invalidate dependent resources. This does not bypass a rejected Custom Hook; use skipHooks for that. The caller must have Bypass draft approvals access for Feature Flags, Configs, and Constants in every Project. Otherwise, this field is ignored. Only set this when a person has explicitly asked you to. If a check blocks you, stop and ask a person instead of working around it.
Set to true to publish despite a Custom Hook rejection. This does not bypass schema validation; use skipSchemaValidation for that. The caller must have Bypass draft approvals access for Feature Flags, Configs, and Constants in every Project. Otherwise, this field is ignored. Only set this when a person has explicitly asked you to. If a check blocks you, stop and ask a person instead of working around it.
Was this page helpful?
curl -X POST 'https://api.growthbook.io/api/v1/features/{id}' \
-H 'Authorization: Bearer YOUR_API_KEY'import requests
url = "https://api.growthbook.io/api/v1/features/{id}"
payload = {
"description": "<string>",
"archived": True,
"project": "<string>",
"targetingAllProjects": True,
"targetingProjects": ["<string>"],
"owner": "<string>",
"defaultValue": "<string>",
"baseConfig": "<string>",
"tags": ["<string>"],
"environments": {},
"prerequisites": ["<string>"],
"jsonSchema": "<string>",
"customFields": {},
"holdout": {
"id": "<string>",
"value": "<string>"
},
"comment": "<string>",
"ignoreWarnings": True,
"skipSchemaValidation": True,
"skipHooks": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
description: '<string>',
archived: true,
project: '<string>',
targetingAllProjects: true,
targetingProjects: ['<string>'],
owner: '<string>',
defaultValue: '<string>',
baseConfig: '<string>',
tags: ['<string>'],
environments: {},
prerequisites: ['<string>'],
jsonSchema: '<string>',
customFields: {},
holdout: {id: '<string>', value: '<string>'},
comment: '<string>',
ignoreWarnings: true,
skipSchemaValidation: true,
skipHooks: true
})
};
fetch('https://api.growthbook.io/api/v1/features/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.growthbook.io/api/v1/features/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'description' => '<string>',
'archived' => true,
'project' => '<string>',
'targetingAllProjects' => true,
'targetingProjects' => [
'<string>'
],
'owner' => '<string>',
'defaultValue' => '<string>',
'baseConfig' => '<string>',
'tags' => [
'<string>'
],
'environments' => [
],
'prerequisites' => [
'<string>'
],
'jsonSchema' => '<string>',
'customFields' => [
],
'holdout' => [
'id' => '<string>',
'value' => '<string>'
],
'comment' => '<string>',
'ignoreWarnings' => true,
'skipSchemaValidation' => true,
'skipHooks' => true
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.growthbook.io/api/v1/features/{id}"
payload := strings.NewReader("{\n \"description\": \"<string>\",\n \"archived\": true,\n \"project\": \"<string>\",\n \"targetingAllProjects\": true,\n \"targetingProjects\": [\n \"<string>\"\n ],\n \"owner\": \"<string>\",\n \"defaultValue\": \"<string>\",\n \"baseConfig\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"environments\": {},\n \"prerequisites\": [\n \"<string>\"\n ],\n \"jsonSchema\": \"<string>\",\n \"customFields\": {},\n \"holdout\": {\n \"id\": \"<string>\",\n \"value\": \"<string>\"\n },\n \"comment\": \"<string>\",\n \"ignoreWarnings\": true,\n \"skipSchemaValidation\": true,\n \"skipHooks\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.growthbook.io/api/v1/features/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"description\": \"<string>\",\n \"archived\": true,\n \"project\": \"<string>\",\n \"targetingAllProjects\": true,\n \"targetingProjects\": [\n \"<string>\"\n ],\n \"owner\": \"<string>\",\n \"defaultValue\": \"<string>\",\n \"baseConfig\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"environments\": {},\n \"prerequisites\": [\n \"<string>\"\n ],\n \"jsonSchema\": \"<string>\",\n \"customFields\": {},\n \"holdout\": {\n \"id\": \"<string>\",\n \"value\": \"<string>\"\n },\n \"comment\": \"<string>\",\n \"ignoreWarnings\": true,\n \"skipSchemaValidation\": true,\n \"skipHooks\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.growthbook.io/api/v1/features/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"description\": \"<string>\",\n \"archived\": true,\n \"project\": \"<string>\",\n \"targetingAllProjects\": true,\n \"targetingProjects\": [\n \"<string>\"\n ],\n \"owner\": \"<string>\",\n \"defaultValue\": \"<string>\",\n \"baseConfig\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"environments\": {},\n \"prerequisites\": [\n \"<string>\"\n ],\n \"jsonSchema\": \"<string>\",\n \"customFields\": {},\n \"holdout\": {\n \"id\": \"<string>\",\n \"value\": \"<string>\"\n },\n \"comment\": \"<string>\",\n \"ignoreWarnings\": true,\n \"skipSchemaValidation\": true,\n \"skipHooks\": true\n}"
response = http.request(request)
puts response.read_body{
"feature": {
"id": "<string>",
"dateCreated": "2023-11-07T05:31:56Z",
"dateUpdated": "2023-11-07T05:31:56Z",
"archived": true,
"description": "<string>",
"owner": "<string>",
"project": "<string>",
"valueType": "boolean",
"defaultValue": "<string>",
"tags": [
"<string>"
],
"environments": {},
"revision": {
"version": 123,
"comment": "<string>",
"date": "2023-11-07T05:31:56Z",
"createdBy": "<string>",
"publishedBy": "<string>",
"id": "<string>"
},
"ownerEmail": "<string>",
"targetingAllProjects": true,
"targetingProjects": [
"<string>"
],
"baseConfig": "<string>",
"defaultValueConfig": "<string>",
"prerequisites": [
"<string>"
],
"customFields": {},
"holdout": {
"id": "<string>",
"value": "<string>"
}
},
"bypassedGates": [
{
"type": "<string>",
"outcome": "bypassed",
"via": "ignoreWarnings"
}
]
}{
"confirmation": {
"id": "<string>",
"status": "pending",
"actions": [
{
"action": "feature.create",
"environments": [
"<string>"
]
}
],
"summary": "<string>",
"url": "<string>",
"expiresAt": "<string>",
"response": {
"status": 123,
"body": "<unknown>"
},
"note": "<string>"
},
"message": "<string>"
}
