---
title: "Create prompt version"
method: POST
path: "/api/v1/prompts/{promptH}/versions"
tags: ["Prompts"]
---

# Create prompt version

`POST /api/v1/prompts/{promptH}/versions`

## Request

- Base URL: `https://numonic.ai`
- URL: `https://numonic.ai/api/v1/prompts/{promptH}/versions`
- Auth: API key in header `x-api-key`

Create a new version of an existing prompt. Supports major and minor version bumps with changelog.

## Path parameters

- `promptH` string, required: Prompt SHA-1 hash identifier

## Request body

- object
  - `prompt_text` string, required: Updated prompt text
  - `change_log` string: Description of changes in this version
  - `model_config` object: Updated model parameters
  - `variables_schema` object: Updated template variable definitions
  - `version_bump` 'major' | 'minor': Version increment type

## Response `201`

Version created

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `404`: Prompt not found

---

[API](https://skmtc.dev/numonic/apis/numonic-api.md) · [All operations](https://skmtc.dev/numonic/apis/numonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/numonic/apis/numonic-api/revisions/6c559bef1e35?raw)