Atomically publish revisions across multiple entities

Publishes a set of revisions — at most one per entity — across Feature Flags, Saved Groups, configs, and constants as a single all-or-nothing operation.

Validation, guards, and custom hooks run against the combined end-state of the whole set, so interdependent changes (e.g. a config schema change plus the values that depend on it) publish together even when the in-between states would be invalid.

A blocked publish returns one 422 listing every gate across every item and the flag that clears each. A concurrent change to any target aborts with a 409 and nothing publishes. A failure after the commit starts rolls everything back and emits revision.publishFailed for each revision in the set. SDK payloads refresh once per request. Pass dryRun: true for the full gate report with zero writes.

Requires the releases commercial feature.

POST

releases

publish-revisions

cURL

curl -X POST 'https://api.growthbook.io/api/v1/releases/publish-revisions' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import requests

url = "https://api.growthbook.io/api/v1/releases/publish-revisions"

payload = {
    "revisions": [
        {
            "entityType": "feature",
            "id": "<string>",
            "version": 123
        }
    ],
    "dryRun": True,
    "ignoreWarnings": True,
    "skipSchemaValidation": True,
    "skipHooks": True,
    "comment": "<string>"
}
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({
    revisions: [{entityType: 'feature', id: '<string>', version: 123}],
    dryRun: true,
    ignoreWarnings: true,
    skipSchemaValidation: true,
    skipHooks: true,
    comment: '<string>'
  })
};

fetch('https://api.growthbook.io/api/v1/releases/publish-revisions', 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/releases/publish-revisions",
  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([
    'revisions' => [
        [
                'entityType' => 'feature',
                'id' => '<string>',
                'version' => 123
        ]
    ],
    'dryRun' => true,
    'ignoreWarnings' => true,
    'skipSchemaValidation' => true,
    'skipHooks' => true,
    'comment' => '<string>'
  ]),
  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/releases/publish-revisions"

	payload := strings.NewReader("{\n  \"revisions\": [\n    {\n      \"entityType\": \"feature\",\n      \"id\": \"<string>\",\n      \"version\": 123\n    }\n  ],\n  \"dryRun\": true,\n  \"ignoreWarnings\": true,\n  \"skipSchemaValidation\": true,\n  \"skipHooks\": true,\n  \"comment\": \"<string>\"\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/releases/publish-revisions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"revisions\": [\n    {\n      \"entityType\": \"feature\",\n      \"id\": \"<string>\",\n      \"version\": 123\n    }\n  ],\n  \"dryRun\": true,\n  \"ignoreWarnings\": true,\n  \"skipSchemaValidation\": true,\n  \"skipHooks\": true,\n  \"comment\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.growthbook.io/api/v1/releases/publish-revisions")

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  \"revisions\": [\n    {\n      \"entityType\": \"feature\",\n      \"id\": \"<string>\",\n      \"version\": 123\n    }\n  ],\n  \"dryRun\": true,\n  \"ignoreWarnings\": true,\n  \"skipSchemaValidation\": true,\n  \"skipHooks\": true,\n  \"comment\": \"<string>\"\n}"

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

{
  "dryRun": true,
  "results": [
    {
      "id": "<string>",
      "version": 123,
      "revisionId": "<string>"
    }
  ],
  "gates": [
    {
      "id": "<string>",
      "version": 123,
      "type": "<string>",
      "messages": [
        "<string>"
      ],
      "override": "<string>",
      "requiresPermission": "<string>",
      "resolution": {
        "action": "<string>",
        "method": "<string>",
        "path": "<string>"
      }
    }
  ],
  "bypassedGates": [
    {
      "id": "<string>",
      "version": 123,
      "type": "<string>",
      "via": "<string>"
    }
  ],
  "warnings": [
    "<string>"
  ],
  "bulkPublishId": "<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"

Body

application/json

revisions

object[]

required

The revisions to publish, at most one per entity.

Required array length: 1 - 50 elements

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

dryRun

boolean

Report every gate and outcome without writing anything.

ignoreWarnings

boolean

Set to true to acknowledge warnings from experiment guards, schema changes, or archives. It can also force-publish an out-of-date draft when the caller has Bypass draft approvals access for that resource.

skipSchemaValidation

boolean

Set to true to publish despite schema or invariant failures. Validation still runs and the response still reports each failure. The caller must have Bypass draft approvals access for Feature Flags, Configs, and Constants in every Project.

skipHooks

boolean

Set to true to publish despite Custom Hook rejections. The caller must have Bypass draft approvals access for Feature Flags, Configs, and Constants in every Project.

comment

string

An optional publish comment recorded on every revision in this release — it appears in each entity's revision history and is passed to any custom validation hooks that run for the publish.

Response

200 - application/json

Resource created

dryRun

boolean

required

results

object[]

required

Show child attributes

gates

object[]

required

Dry runs report every gate, cleared and blocking. Real publishes return an empty list — blocking gates fail with a 422 instead.

Show child attributes

bypassedGates

object[]

required

Gates bypassed by the caller's flags or authority — what this publish overrode.

Show child attributes

warnings

string[]

required

bulkPublishId

string

Correlation token (pub_…) stamped on every event this publish emitted. Absent on dry runs.

cURL

curl -X POST 'https://api.growthbook.io/api/v1/releases/publish-revisions' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import requests

url = "https://api.growthbook.io/api/v1/releases/publish-revisions"

payload = {
    "revisions": [
        {
            "entityType": "feature",
            "id": "<string>",
            "version": 123
        }
    ],
    "dryRun": True,
    "ignoreWarnings": True,
    "skipSchemaValidation": True,
    "skipHooks": True,
    "comment": "<string>"
}
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({
    revisions: [{entityType: 'feature', id: '<string>', version: 123}],
    dryRun: true,
    ignoreWarnings: true,
    skipSchemaValidation: true,
    skipHooks: true,
    comment: '<string>'
  })
};

fetch('https://api.growthbook.io/api/v1/releases/publish-revisions', 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/releases/publish-revisions",
  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([
    'revisions' => [
        [
                'entityType' => 'feature',
                'id' => '<string>',
                'version' => 123
        ]
    ],
    'dryRun' => true,
    'ignoreWarnings' => true,
    'skipSchemaValidation' => true,
    'skipHooks' => true,
    'comment' => '<string>'
  ]),
  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/releases/publish-revisions"

	payload := strings.NewReader("{\n  \"revisions\": [\n    {\n      \"entityType\": \"feature\",\n      \"id\": \"<string>\",\n      \"version\": 123\n    }\n  ],\n  \"dryRun\": true,\n  \"ignoreWarnings\": true,\n  \"skipSchemaValidation\": true,\n  \"skipHooks\": true,\n  \"comment\": \"<string>\"\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/releases/publish-revisions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"revisions\": [\n    {\n      \"entityType\": \"feature\",\n      \"id\": \"<string>\",\n      \"version\": 123\n    }\n  ],\n  \"dryRun\": true,\n  \"ignoreWarnings\": true,\n  \"skipSchemaValidation\": true,\n  \"skipHooks\": true,\n  \"comment\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.growthbook.io/api/v1/releases/publish-revisions")

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  \"revisions\": [\n    {\n      \"entityType\": \"feature\",\n      \"id\": \"<string>\",\n      \"version\": 123\n    }\n  ],\n  \"dryRun\": true,\n  \"ignoreWarnings\": true,\n  \"skipSchemaValidation\": true,\n  \"skipHooks\": true,\n  \"comment\": \"<string>\"\n}"

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

{
  "dryRun": true,
  "results": [
    {
      "id": "<string>",
      "version": 123,
      "revisionId": "<string>"
    }
  ],
  "gates": [
    {
      "id": "<string>",
      "version": 123,
      "type": "<string>",
      "messages": [
        "<string>"
      ],
      "override": "<string>",
      "requiresPermission": "<string>",
      "resolution": {
        "action": "<string>",
        "method": "<string>",
        "path": "<string>"
      }
    }
  ],
  "bypassedGates": [
    {
      "id": "<string>",
      "version": 123,
      "type": "<string>",
      "via": "<string>"
    }
  ],
  "warnings": [
    "<string>"
  ],
  "bulkPublishId": "<string>"
}

Introduction

Endpoints

Models

Atomically publish revisions across multiple entities

Authorizations

Body

Response