Skip to main content
GET
/
v1
/
prompts
/
{id}
/
versions
List Prompt Versions
curl --request GET \
  --url http://localhost:3000/v1/prompts/{id}/versions \
  --header 'Authorization: Bearer <token>'
{
  "versions": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "prompt_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "version": 123,
      "template": "Hello {{.name}}!",
      "created_at": "2023-11-07T05:31:56Z",
      "published_at": "2023-11-07T05:31:56Z",
      "tags": [
        "<string>"
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

Use an access token retrieved from login (Bearer sess_...) or a programmatic API key (Bearer ak_...).

Path Parameters

id
string<uuid>
required

Unique prompt UUID.

Query Parameters

tags
string

Optional comma-separated list of tags to filter prompt versions.

status
enum<string>

Optional status to filter prompt versions by (draft, live, archived).

Available options:
draft,
live,
archived

Response

List of versions

versions
object[]
required