Skip to content

Revisions

Immutable versions of a service's or an agent's definition.

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.

Type to search…

↑↓ navigate↵ selectEsc close