Prompts

List versions for a prompt

GET
/api/prompts/{promptId}/versions

Returns paginated version snapshots for a prompt the caller owns or has acquired as an editable reference. Each item is a summary (preview, displayVersion, label, source) and is marked as matchesCurrentPrompt when its text equals the live prompt.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

promptId*string

Query Parameters

limit?integer
Range1 <= value <= 100
Default20
skip?integer
Range0 <= value
Default0

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/prompts/string/versions"
{  "versions": [    {      "_id": "65f9b1c2e8a1d4e001a0b1c3",      "version": 4,      "displayVersion": "v1.3",      "source": "manual_save",      "createdAt": "2026-04-22T10:14:00.000Z",      "matchesCurrentPrompt": true,      "preview": "<prompt>..."    }  ],  "total": 7,  "limit": 20,  "skip": 0}