Version control

Every change to a prompt in the Prompt Library creates a new immutable version, numbered sequentially as v1, v2, v3, … Once created, a version can’t be modified — you always have a full audit trail.

You can create new versions from the Opik UI or from code using the SDK.

Creating a new version

Fetching a specific version

Pass the version parameter to fetch a specific version, or omit it to fetch the most recent:

1
import opik
2
3
client = opik.Opik()
4
5
# Fetch a specific version
6
v3 = client.get_prompt(name="system_prompt", version="v3", project_name="my-agent")
7
8
# Fetch the most recent version (omit `version`)
9
latest = client.get_prompt(name="system_prompt", project_name="my-agent")

Comparing versions

You can compare any two versions side-by-side in the Opik UI to see exactly what changed. This is useful for reviewing changes before pointing your agent at a new version.