Skip to main content
Roberty Studio
IDPIDP

Versions

Publish versions of an IDP template, choose which one answers in production and roll back to an earlier version when you need to.

Versions

Everything you edit in the template goes into the draft. Publishing freezes the whole pipeline configuration into a version — reference document, pages, filters, identification, extraction, post-processing, validations and model. The Versions tab shows what has been published and which version is active.

The active version is the one that answers in production: the API and webhook, the robot action and the AI agent action always run the active version, never the draft. Changes to the draft only reach the template's users once they are published. See Using templates in automations.

Only workspace developers and administrators can publish and activate versions.

Publishing a version​

Click Publish at the top of the template, or Publish version in the Versions tab. Unsaved changes are saved first, so they make it into the version. The dialog shows the Current version and the New version and asks for:

FieldRequiredDescription
Kind of change—Fix, Improvement or Big change. Each option shows the resulting number based on the highest version published so far: from 1.2.0, for example, it goes to 1.2.1, 1.3.0 or 2.0.0. On the first publish, the options start at 0.0.1, 0.1.0 and 1.0.0.
Version numberYesFilled in by the kind of change, and editable. Use semver format, for example 1.2.0; suffixes such as 1.2.0-beta.1 are accepted too. The number cannot repeat one already published for the template.
What changedNoUp to 10,000 characters. Summarize what the version brings; the text shows in the version list.
Make this the active version—On by default. When on, the new version starts answering in production right away. When off, the version is published as Archived and the current active version keeps answering.

Click Publish to finish.

Version list​

The Versions tab lists versions from newest to oldest. Each row shows the version number, the publish date and time, the description and the status:

StatusMeaning
ActiveThe version that answers in production. A template has at most one.
ArchivedA published version that is not answering. It can be activated at any time.

The list offers no way to edit or delete published versions. To change how the template behaves, edit the draft and publish a new version.

Rolling back to an earlier version​

To undo a publish, click Activate on the row of an archived version and confirm. Production and the API start using that version immediately, and the version that was active becomes Archived. The draft does not change.

No active version​

While the template has no active version, it does not answer in production. The editor shows the No published version notice, with a Publish version shortcut, and:

  • the API refuses calls with status 409 and the NO_ACTIVE_VERSION error. See API and webhook;
  • the robot action and the AI agent action fail with the NO_ACTIVE_VERSION error.

The Playground, Simulate API and the evaluation sets keep working, because they run the draft. See Playground and Simulate API.