Skip to content

Infisical is the open-source platform for securing secrets, certificates, access, and AI Agents.

1.6 KB
Raw Blame
---
title: "Secret versioning"
description: "Learn how secret versioning works in Infisical."
---

Every time a secret change is performed, a new version of the same secret is created. 

The short video below walks through secret versioning and point-in-time recovery, covering how Infisical keeps a history of every secret change and how to roll back to a previous state.

<br />

<div style={{ position: "relative", paddingBottom: "56.25%", height: 0, overflow: "hidden", maxWidth: "100%" }}>
  <iframe
    src="https://www.youtube.com/embed/tWVQcx4XiAA"
    title="YouTube video player"
    style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }}
    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
    allowfullscreen
  ></iframe>
</div>

<br />

To see a secret's versions, hover over it, select the three dot menu, then select **Version History**. You can also [read a specific version through the API](/api-reference/endpoints/secrets/read) with the `version` query parameter.

![Three dot menu open on a secret row, showing Version History](../../images/platform/secret-versioning-overview.png)

![Version History panel listing three versions of a secret](../../images/platform/secret-versioning.png)

The secret versioning functionality is heavily connected to [Point-in-time Recovery](/documentation/platform/pit-recovery) of secrets in Infisical.

<Note>
  Select the restore icon on any earlier version to roll the secret back to it.
  This overwrites the current value and adds a new version at the top of the
  stack.
</Note>