---
title: "Changes to Create prompt version"
method: POST
path: "/v1/private/prompts/versions"
---

# Changes to Create prompt version

`POST /v1/private/prompts/versions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 59 revisions.

- **2026-05-28** `f59fc1819c0c` — 2 info
- **2026-05-27** `3953a50a6a0e` — 2 warning, 2 info
- **2026-05-20** `a98bd55ddc1e` — 1 info
- **2026-05-19** `415a5d0ad31f` — 2 info
- **2026-05-19** `f93aac27fb6e` — 9 warning, 5 info
- **2026-05-04** `d606e84c75e4` — 10 warning, 9 info

## Changes

- **2026-05-28** `f59fc1819c0c` — 2 info
  - added the new optional request property `version/environment`
  - added the optional property `environment` to the response with the `200` status
- **2026-05-27** `3953a50a6a0e` — 2 warning, 2 info
  - removed the request property `version/environment`
  - removed the optional property `environment` from the response with the `200` status
  - added the new optional request property `version/environments`
  - added the optional property `environments` to the response with the `200` status
- **2026-05-20** `a98bd55ddc1e` — 1 info
  - added the optional property `version_number` to the response with the `200` status
- **2026-05-19** `415a5d0ad31f` — 2 info
  - added the new optional request property `version/environment`
  - added the optional property `environment` to the response with the `200` status
- **2026-05-19** `f93aac27fb6e` — 9 warning, 5 info
  - removed the optional property `code` from the response with the `400` status
  - removed the optional property `code` from the response with the `409` status
  - removed the optional property `code` from the response with the `422` status
  - removed the optional property `details` from the response with the `400` status
  - removed the optional property `details` from the response with the `409` status
  - removed the optional property `details` from the response with the `422` status
  - removed the optional property `message` from the response with the `400` status
  - removed the optional property `message` from the response with the `409` status
  - removed the optional property `message` from the response with the `422` status
  - added the new optional request property `version/version_type`
  - added the optional property `errors` to the response with the `400` status
  - added the optional property `errors` to the response with the `409` status
  - added the optional property `errors` to the response with the `422` status
  - added the optional property `version_type` to the response with the `200` status
- **2026-05-04** `d606e84c75e4` — 10 warning, 9 info
  - removed the request property `version/environment`
  - removed the request property `version/environments`
  - removed the request property `version/version_type`
  - removed the optional property `environment` from the response with the `200` status
  - removed the optional property `environments` from the response with the `200` status
  - removed the optional property `errors` from the response with the `400` status
  - removed the optional property `errors` from the response with the `409` status
  - removed the optional property `errors` from the response with the `422` status
  - removed the optional property `version_number` from the response with the `200` status
  - removed the optional property `version_type` from the response with the `200` status
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `409` status
  - added the optional property `code` to the response with the `422` status
  - added the optional property `details` to the response with the `400` status
  - added the optional property `details` to the response with the `409` status
  - added the optional property `details` to the response with the `422` status
  - added the optional property `message` to the response with the `400` status
  - added the optional property `message` to the response with the `409` status
  - added the optional property `message` to the response with the `422` status

---

[Operation](https://skmtc.dev/comet-ml/apis/opik-rest-api/docs/v1/private/prompts/versions/post.md) · [API](https://skmtc.dev/comet-ml/apis/opik-rest-api.md) · [Page](https://skmtc.dev/comet-ml/apis/opik-rest-api/changes/v1/private/prompts/versions/post)