Revert the constant to a prior revision

POST

constants-revisions

{key}

{version}

revert

cURL

curl -X POST 'https://api.growthbook.io/api/v1/constants-revisions/{key}/{version}/revert' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import requests

url = "https://api.growthbook.io/api/v1/constants-revisions/{key}/{version}/revert"

payload = {
    "title": "<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({
    title: '<string>',
    comment: '<string>',
    ignoreWarnings: true,
    skipSchemaValidation: true,
    skipHooks: true
  })
};

fetch('https://api.growthbook.io/api/v1/constants-revisions/{key}/{version}/revert', 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/constants-revisions/{key}/{version}/revert",
  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([
    'title' => '<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/constants-revisions/{key}/{version}/revert"

	payload := strings.NewReader("{\n  \"title\": \"<string>\",\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/constants-revisions/{key}/{version}/revert")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"<string>\",\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/constants-revisions/{key}/{version}/revert")

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  \"title\": \"<string>\",\n  \"comment\": \"<string>\",\n  \"ignoreWarnings\": true,\n  \"skipSchemaValidation\": true,\n  \"skipHooks\": true\n}"

response = http.request(request)
puts response.read_body

{
  "revision": {
    "id": "<string>",
    "status": "draft",
    "authorId": "<string>",
    "reviews": [
      {
        "id": "<string>",
        "userId": "<string>",
        "decision": "approve",
        "dateCreated": "2023-11-07T05:31:56Z",
        "comment": "<string>",
        "stale": true,
        "user": {
          "type": "dashboard",
          "id": "<string>",
          "apiKey": "<string>",
          "name": "<string>",
          "email": "<string>",
          "requestedBy": {
            "id": "<string>",
            "name": "<string>",
            "email": "<string>"
          },
          "assumedRole": true
        }
      }
    ],
    "activityLog": [
      {
        "id": "<string>",
        "userId": "<string>",
        "action": "created",
        "dateCreated": "2023-11-07T05:31:56Z",
        "description": "<string>",
        "proposedChangesSnapshot": [
          {
            "op": "add",
            "path": "<string>",
            "value": "<unknown>"
          }
        ],
        "targetSnapshot": "<unknown>",
        "user": {
          "type": "dashboard",
          "id": "<string>",
          "apiKey": "<string>",
          "name": "<string>",
          "email": "<string>",
          "requestedBy": {
            "id": "<string>",
            "name": "<string>",
            "email": "<string>"
          },
          "assumedRole": true
        }
      }
    ],
    "dateCreated": "2023-11-07T05:31:56Z",
    "dateUpdated": "2023-11-07T05:31:56Z",
    "baseConstant": {
      "id": "<string>",
      "key": "<string>",
      "name": "<string>",
      "type": "string",
      "dateCreated": "2023-11-07T05:31:56Z",
      "dateUpdated": "2023-11-07T05:31:56Z",
      "owner": "<string>",
      "ownerEmail": "<string>",
      "value": "<string>",
      "environmentValues": {},
      "description": "<string>",
      "project": "<string>",
      "archived": true
    },
    "proposedConstant": {
      "id": "<string>",
      "key": "<string>",
      "name": "<string>",
      "type": "string",
      "dateCreated": "2023-11-07T05:31:56Z",
      "dateUpdated": "2023-11-07T05:31:56Z",
      "owner": "<string>",
      "ownerEmail": "<string>",
      "value": "<string>",
      "environmentValues": {},
      "description": "<string>",
      "project": "<string>",
      "archived": true
    },
    "proposedChanges": [
      {
        "op": "add",
        "path": "<string>",
        "value": "<unknown>"
      }
    ],
    "version": 123,
    "title": "<string>",
    "author": {
      "type": "dashboard",
      "id": "<string>",
      "apiKey": "<string>",
      "name": "<string>",
      "email": "<string>",
      "requestedBy": {
        "id": "<string>",
        "name": "<string>",
        "email": "<string>"
      },
      "assumedRole": true
    },
    "authorEmail": "<string>",
    "contributors": [
      "<string>"
    ],
    "revertedFrom": "<string>",
    "autoPublishOnApproval": true,
    "autoPublishEnabledBy": "<string>",
    "autoPublishEnabledByUser": {
      "type": "dashboard",
      "id": "<string>",
      "apiKey": "<string>",
      "name": "<string>",
      "email": "<string>",
      "requestedBy": {
        "id": "<string>",
        "name": "<string>",
        "email": "<string>"
      },
      "assumedRole": true
    },
    "scheduledPublishAt": "2023-11-07T05:31:56Z",
    "scheduledPublishLockEdits": true,
    "scheduledPublishLockOthers": true,
    "scheduledPublishBypassApproval": true,
    "scheduledPublishAttempts": 123,
    "scheduledPublishLastError": "<string>",
    "scheduledPublishGaveUpAt": "2023-11-07T05:31:56Z",
    "resolution": {
      "action": "merged",
      "userId": "<string>",
      "dateCreated": "2023-11-07T05:31:56Z",
      "user": {
        "type": "dashboard",
        "id": "<string>",
        "apiKey": "<string>",
        "name": "<string>",
        "email": "<string>",
        "requestedBy": {
          "id": "<string>",
          "name": "<string>",
          "email": "<string>"
        },
        "assumedRole": true
      }
    }
  },
  "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

Authorization

string

header

required

If using Bearer auth, pass the Secret Key as the token:

curl https://api.growthbook.io/api/v1/features   -H "Authorization: Bearer secret_abc123DEF456"

Path Parameters

key

string

required

version

integer

required

Body

application/json

strategy

enum<string>

Whether to stage the revert as a draft or publish it immediately. Defaults to draft, or to publish when the org enables 'reverts bypass approval'.

Available options:

draft,

publish

title

string

Short draft title (e.g. Enable for beta testers).

comment

string

Currently ignored. Use title to describe the revert.

ignoreWarnings

boolean

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.

skipSchemaValidation

boolean

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.

skipHooks

boolean

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.

Response

Resource created

revision

object

required

Show child attributes

bypassedGates

object[]

Gates that would have blocked this publish but were bypassed by the caller's authority. Present only when at least one gate was bypassed.

Show child attributes

cURL

curl -X POST 'https://api.growthbook.io/api/v1/constants-revisions/{key}/{version}/revert' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import requests

url = "https://api.growthbook.io/api/v1/constants-revisions/{key}/{version}/revert"

payload = {
    "title": "<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({
    title: '<string>',
    comment: '<string>',
    ignoreWarnings: true,
    skipSchemaValidation: true,
    skipHooks: true
  })
};

fetch('https://api.growthbook.io/api/v1/constants-revisions/{key}/{version}/revert', 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/constants-revisions/{key}/{version}/revert",
  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([
    'title' => '<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/constants-revisions/{key}/{version}/revert"

	payload := strings.NewReader("{\n  \"title\": \"<string>\",\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/constants-revisions/{key}/{version}/revert")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"<string>\",\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/constants-revisions/{key}/{version}/revert")

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  \"title\": \"<string>\",\n  \"comment\": \"<string>\",\n  \"ignoreWarnings\": true,\n  \"skipSchemaValidation\": true,\n  \"skipHooks\": true\n}"

response = http.request(request)
puts response.read_body

{
  "revision": {
    "id": "<string>",
    "status": "draft",
    "authorId": "<string>",
    "reviews": [
      {
        "id": "<string>",
        "userId": "<string>",
        "decision": "approve",
        "dateCreated": "2023-11-07T05:31:56Z",
        "comment": "<string>",
        "stale": true,
        "user": {
          "type": "dashboard",
          "id": "<string>",
          "apiKey": "<string>",
          "name": "<string>",
          "email": "<string>",
          "requestedBy": {
            "id": "<string>",
            "name": "<string>",
            "email": "<string>"
          },
          "assumedRole": true
        }
      }
    ],
    "activityLog": [
      {
        "id": "<string>",
        "userId": "<string>",
        "action": "created",
        "dateCreated": "2023-11-07T05:31:56Z",
        "description": "<string>",
        "proposedChangesSnapshot": [
          {
            "op": "add",
            "path": "<string>",
            "value": "<unknown>"
          }
        ],
        "targetSnapshot": "<unknown>",
        "user": {
          "type": "dashboard",
          "id": "<string>",
          "apiKey": "<string>",
          "name": "<string>",
          "email": "<string>",
          "requestedBy": {
            "id": "<string>",
            "name": "<string>",
            "email": "<string>"
          },
          "assumedRole": true
        }
      }
    ],
    "dateCreated": "2023-11-07T05:31:56Z",
    "dateUpdated": "2023-11-07T05:31:56Z",
    "baseConstant": {
      "id": "<string>",
      "key": "<string>",
      "name": "<string>",
      "type": "string",
      "dateCreated": "2023-11-07T05:31:56Z",
      "dateUpdated": "2023-11-07T05:31:56Z",
      "owner": "<string>",
      "ownerEmail": "<string>",
      "value": "<string>",
      "environmentValues": {},
      "description": "<string>",
      "project": "<string>",
      "archived": true
    },
    "proposedConstant": {
      "id": "<string>",
      "key": "<string>",
      "name": "<string>",
      "type": "string",
      "dateCreated": "2023-11-07T05:31:56Z",
      "dateUpdated": "2023-11-07T05:31:56Z",
      "owner": "<string>",
      "ownerEmail": "<string>",
      "value": "<string>",
      "environmentValues": {},
      "description": "<string>",
      "project": "<string>",
      "archived": true
    },
    "proposedChanges": [
      {
        "op": "add",
        "path": "<string>",
        "value": "<unknown>"
      }
    ],
    "version": 123,
    "title": "<string>",
    "author": {
      "type": "dashboard",
      "id": "<string>",
      "apiKey": "<string>",
      "name": "<string>",
      "email": "<string>",
      "requestedBy": {
        "id": "<string>",
        "name": "<string>",
        "email": "<string>"
      },
      "assumedRole": true
    },
    "authorEmail": "<string>",
    "contributors": [
      "<string>"
    ],
    "revertedFrom": "<string>",
    "autoPublishOnApproval": true,
    "autoPublishEnabledBy": "<string>",
    "autoPublishEnabledByUser": {
      "type": "dashboard",
      "id": "<string>",
      "apiKey": "<string>",
      "name": "<string>",
      "email": "<string>",
      "requestedBy": {
        "id": "<string>",
        "name": "<string>",
        "email": "<string>"
      },
      "assumedRole": true
    },
    "scheduledPublishAt": "2023-11-07T05:31:56Z",
    "scheduledPublishLockEdits": true,
    "scheduledPublishLockOthers": true,
    "scheduledPublishBypassApproval": true,
    "scheduledPublishAttempts": 123,
    "scheduledPublishLastError": "<string>",
    "scheduledPublishGaveUpAt": "2023-11-07T05:31:56Z",
    "resolution": {
      "action": "merged",
      "userId": "<string>",
      "dateCreated": "2023-11-07T05:31:56Z",
      "user": {
        "type": "dashboard",
        "id": "<string>",
        "apiKey": "<string>",
        "name": "<string>",
        "email": "<string>",
        "requestedBy": {
          "id": "<string>",
          "name": "<string>",
          "email": "<string>"
        },
        "assumedRole": true
      }
    }
  },
  "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>"
}

Introduction

Endpoints

Models

Authorizations

Path Parameters

Body

Response