---
title: "List prompt versions"
method: GET
path: "/api/v1/prompts/{promptH}/versions"
tags: ["Prompts"]
---

# List prompt versions

`GET /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`

Retrieve the version history for a prompt, ordered by load date descending. Each version includes prompt text, changelog, model config, and variable schema.

## Path parameters

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

## Response `200`

Version list

- object
  - `prompt` string, required: Prompt hash
  - `versions` object[], required

## Other responses

- `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/ef8104206f32?raw)