Jinba Toolbox
Guides

Version Management

ToolSet publishing and rollback

Overview

To use Tools externally, you need to publish the ToolSet to create a version.

Draft (editing) → Publish → Version 1.0.0 (immutable)
                         → Version 1.1.0 (immutable)

Versions use semantic versioning (x.y.z format).

Publish

  1. Open the "Versions" tab on the ToolSet screen
  2. Click "Publish New Version"
  3. Enter version number (e.g., 1.0.0)
  4. Enter release notes (optional)
  5. Click "Publish"

Publishing saves all Tools as an immutable snapshot at that point in time.

Published Versions

  • latestVersion - The last published version
  • publishedVersion - Currently active version (used by API)

Both are typically updated when publishing.

Rollback

Change the publishedVersion to a previous version in the "Versions" tab to rollback.

Draft

When you edit a Tool, it becomes a "Draft" until published. Draft changes can be tested via the /test endpoint but are not used by /run.

On this page