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:
| Field | Required | Description |
|---|---|---|
| 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 number | Yes | Filled 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 changed | No | Up 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:
| Status | Meaning |
|---|---|
| Active | The version that answers in production. A template has at most one. |
| Archived | A 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
409and theNO_ACTIVE_VERSIONerror. See API and webhook; - the robot action and the AI agent action fail with the
NO_ACTIVE_VERSIONerror.
The Playground, Simulate API and the evaluation sets keep working, because they run the draft. See Playground and Simulate API.