- Set - allows you to see the history of the entire Set with every change
- Config - allows you to see the history of a specific config (key & set)
- Version Tag - allows you to set a snapshot as a version and then jump between versions

Revision Tags
Tags are a way to mark a specific snapshot of the organization’s configs as a version. Once a tag is created, you can compare it with the current state of your organization and revert to it. Tags can be created, viewed, and reverted only by the organization’s admins.Tags can only be created and applied to the entire organization, not to a specific set or config.
Create a tag
In order to create a tag you’ll first need to create a token with theAdmin
role.
See Tokens for more information about creating tokens and assigning them roles.
Once your token is ready, you can create a tag with the following request to our API:
Tag can be any alphanumeric string. optionally with the following characters:
. _ / -
Your organization ID can be found under organization settings



Only members with the
Admin
role have permission to access the show diff
and revert
actions.Evaluating with a tag
You can use a tag to evaluate your configs with a specific snapshot of any existing tags to ensure your evaluations are deterministic. To do this, useConfiguConfigStore
with the tag
parameter using any existing tag name.
Example usage with the Node.js SDK:
CONFIGU_TAG
environment variable to the tag name you wish to use or provide the tag
parameter directly via a .configu
file.
- Attempting to evaluate a tag that does not exist will result in an error.
- Evaluating configs without having the
read
permission will return an empty value.
- Evaluations with a tag will be marked with the tag in the audit log. -
Evaluations with a tag will trigger webhooks with the tag name in the payload as
tag
.
Exploring a tag
You can view the content of a tag by clickingexplore tag
.


All navigation options are disabled during tag exploration.
All regular config action menu options besides
You can view the value of the configs if you have the appropriate permission.
All regular config action menu options besides
show value
are disabled during tag exploration.You can view the value of the configs if you have the appropriate permission.
return to latest tag
in the banner at the top of the page.

Rollbacks
For every history log entry, you will see a Revert Changes button inside the diff window.