---
title: "Creates a new policy version"
method: POST
path: "/policy/{packageName}/version"
tags: ["policy/version"]
---

# Creates a new policy version

`POST /policy/{packageName}/version`

## Path parameters

- `packageName` string, required

## Request body

- VersionChanges
  - `changes` string, required — Updated changelog information

## Response `200`

Successful operation

- PolicyVersionDef
  - `_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 — Policy package name
  - `version` string, required — Policy version
  - `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
  - `status` 'invalid' | 'validating' | 'valid' | 'error', required — Policy status
  - `ipfsCid` string, required — IPFS CID
  - `parameters` object, required — Schema parameters
    - `uiSchema` string, required — UI Schema for parameter display
    - `jsonSchema` string, required — JSON Schema for parameter validation

## Other responses

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

## Changes

- **2025-06-19** `e514cea423bb` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/lit-protocol/apis/vincent-registry-api/changes/policy/:packageName/version/post.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/e514cea423bb/schema)