Method: projects.remoteConfig.rollback

Roll back a project's published Remote Config template to the one specified by the provided version number.

A rollback is equivalent to getting a previously published Remote Config template, and re-publishing it using a force update. Returns the published RemoteConfig and the updated ETag as a response header if successful, or an error.

To roll back the server-side template, use "firebase-server" as the namespace ID in [RollbackRemoteConfigRequest.name]. If [RollbackRemoteConfigRequest.name] is not provided, the client-side template ('firebase' namespace) is rolled back.

See the publishing guide for a list oferror codes. In particular, note that the method returns an error with HTTP Status 404 if the requestedversionNumber to rollback to is not found.

HTTP request

POST https://firebaseremoteconfig.googleapis.com/v1/{project=projects/*}/remoteConfig:rollback

The URL usesgRPC Transcoding syntax.

Path parameters

Parameters
project

string

The Firebase project's Project ID or Project Number, prefixed with "projects/". This field is required if thename field is not provided.

Request body

The request body contains data with the following structure:

JSON representation
{"versionNumber":string,"name":string}
Fields
versionNumber

string (int64 format)

Required. The version number of theRemoteConfig to roll back to. The specified version number must be less than the current version number, and not have been deleted due to staleness.

name

string

Optional. The name of the RemoteConfig to rollback. Format: projects/{project}/namespaces/{namespace}/remoteConfig Project is a Firebase project ID or project number. Namespace is the namespace ID (e.g.: firebase or firebase-server)

Response body

If successful, the response body contains an instance ofRemoteConfig.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/firebase.remoteconfig
  • https://www.googleapis.com/auth/cloud-platform

For more information, see theOAuth 2.0 Overview.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-10-03 UTC.