---
title: "Revisions"
description: "Immutable versions of a service's or an agent's definition."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.jgcp.mistrivedev.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Revisions

:::note[Planned]
Revisions are not available yet.
:::

A revision is one version of a service's or an agent's definition: its sandbox specification, its processes and, for an agent, its protocol and session volume. A revision never changes after you create it.

## The active revision

Each service and agent points at one active revision, in `activeRevision`. Creating the service or agent creates its first revision and makes it active.

To change the definition, create a new revision with `revisions.create`, then make it active with `update({ activeRevision })`. To roll back, make an earlier revision active again. `revisions.list` returns every revision.

## Running instances keep their revision

New instances use the active revision. An instance that is already running keeps the revision it started with:

- For an agent, a running session stays on its revision. New sessions use the active one.
- For a service, a sandbox that is running keeps its revision. Sandboxes started after the change use the new one.

Source: https://docs.jgcp.mistrivedev.com/services/revisions/index.mdx
