Prompt Versions

List Prompt Versions

Lists all template versions associated with a prompt container.

get/v1/prompts/{id}/versions

Path parameters

idstring uuid required

Unique prompt UUID.

Query parameters

tagsstring

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

status'draft' | 'live' | 'archived'

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

Response

List of versions

Example response

{
  "versions": [
    {
      "template": "Hello {{.name}}!",
      "model": "anthropic/claude-opus-4-6",
      "model_params": {
        "temperature": 0.7,
        "max_tokens": 1024,
        "thinking": {
          "type": "enabled",
          "budget_tokens": 512
        }
      }
    }
  ]
}

Changes

Changed in 5 of the 18 revisions of this API.110

    • added the required property versions/items/model to the response with the 200 status

      response-required-property-added

    • added the required property versions/items/model_params to the response with the 200 status

      response-required-property-added

    • the endpoint scheme security ApiKeyAuth was removed from the API

      api-security-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • api tag Prompt Versions added

      api-tag-added

    • api tag Prompts removed

      api-tag-removed

  • 27457b167aec13See the full diff
    • added the new stable enum value to the versions/items/status response property for the response status 200

      response-property-enum-value-added

    • added the new optional query request parameter status

      new-optional-request-parameter

    • added the new optional query request parameter tags

      new-optional-request-parameter

    • added the required property versions/items/tags to the response with the 200 status

      response-required-property-added

    • api tag Prompts added

      api-tag-added

    • api tag Versions removed

      api-tag-removed