---
title: "Edits a tool version"
method: PUT
path: "/tool/{packageName}/version/{version}"
tags: ["ToolVersion"]
---

# Edits a tool version

`PUT /tool/{packageName}/version/{version}`

## Path parameters

- `packageName` string, required
- `version` string, required

## Request body

- ToolVersionEdit
  - `changes` string, required — Changelog information for this version

## Response `200`

Successful operation

- ToolVersion
  - `_id` string, required — Document ID
  - `updatedAt` string, date-time, required — Timestamp when this was last modified
  - `createdAt` string, date-time, required — Timestamp when this was created
  - `packageName` string, required — Tool NPM package name
  - `version` string, required — Tool version - must be an exact semver.
  - `changes` string, required — Changelog information for this version
  - `repository` string[], required — Repository URLs
  - `description` string, required — Policy description
  - `keywords` string[], required — Keywords for the policy
  - `dependencies` string[], required — Dependencies of the policy
  - `author` object, required — Author information
    - `name` string, required — Name of the author
    - `email` string, email, required — Email of the author
    - `url` string, uri — URL of the author's website
  - `contributors` object[], required — Contributors information
    - `name` string, required — Name of the contributor
    - `email` string, email, required — Email of the contributor
    - `url` string, uri — URL of the contributor's website
  - `homepage` string, uri — Policy homepage
  - `supportedPolicies` object, required — Supported policies. These are detected from 'dependencies' in the tool's package.json.
  - `ipfsCid` string, required — IPFS CID of the code that implements this tool.
  - `policiesNotInRegistry` string[], required — Policy versions that are not in the registry but are supported by this tool

## Other responses

- `400` — Invalid input
- `422` — Validation exception
- `default` — Unexpected error

## Changes

- **2025-06-28** `f7b25b5b140b` — 3 info
  - the endpoint scheme security `siweAuth` was added to the API
  - api tag `ToolVersion` added
  - api tag `tool/version` removed
- **2025-06-27** `45fe72b0582e` — 1 breaking
  - the `supportedPolicies` response's property type/format changed from `array`/`` to `object`/`` for status `200`
- **2025-06-25** `bb58bbc71eae` — 1 info
  - added the required property `policiesNotInRegistry` to the response with the `200` status
- **2025-06-24** `27ae1265cdb9` — 2 warning
  - removed the request property `packageName`
  - removed the request property `version`
- **2025-06-24** `d4634804dbfb` — 3 breaking, 6 info
  - added the new required request property `packageName`
  - added the new required request property `version`
  - removed the required property `status` from the response with the `200` status
  - added the required property `_id` to the response with the `200` status
  - …5 more

[Full history](https://skmtc.dev/lit-protocol/apis/vincent-registry-api/changes/tool/:packageName/version/:version/put.md)

---

[API](https://skmtc.dev/lit-protocol/apis/vincent-registry-api.md) · [All operations](https://skmtc.dev/lit-protocol/apis/vincent-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lit-protocol/vincent-registry-api/revisions/7a8a3bcdf96f/schema)