Get prompt versions

Get all versions for a prompt. Does not include base prompt data, only versioned data.

GET /api/prompts/{id}/versions

Python

Python

import requests

url = "https://app.langwatch.ai/api/prompts/{id}/versions"

headers = {"X-Auth-Token": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

200

[
  {
    "id": "<string>",
    "handle": "<string>",
    "name": "<string>",
    "updatedAt": "<string>",
    "projectId": "<string>",
    "organizationId": "<string>",
    "versionId": "<string>",
    "version": 123,
    "createdAt": "<string>",
    "prompt": "<string>",
    "messages": [],
    "inputs": [],
    "outputs": [
      {
        "identifier": "<string>",
        "json_schema": {
          "type": "<string>"
        }
      }
    ],
    "model": "<string>",
    "tags": [],
    "authorId": "<string>",
    "commitMessage": "<string>",
    "temperature": 123,
    "maxTokens": 123,
    "demonstrations": {
      "id": "<string>",
      "name": "<string>",
      "inline": {
        "records": {},
        "columnTypes": [
          {
            "name": "<string>",
            "type": "<string>",
            "id": "<string>"
          }
        ]
      }
    },
    "promptingTechnique": {
      "demonstrations": {
        "id": "<string>",
        "name": "<string>",
        "inline": {
          "records": {},
          "columnTypes": [
            {
              "name": "<string>",
              "type": "<string>",
              "id": "<string>"
            }
          ]
        }
      }
    },
    "responseFormat": {
      "json_schema": {
        "name": "<string>",
        "schema": {}
      }
    }
  }
]

Authorizations

X-Auth-Token · string · header · required

Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI.

Path Parameters

id · string · required

Response

200

application/json

Success

id · string · required

handle · string | null · required

scope · enum<string> · required

Available options: ORGANIZATION, PROJECT

name · string · required

updatedAt · string · required

projectId · string · required

organizationId · string · required

versionId · string · required

version · number · required

createdAt · string · required

prompt · string · required

messages · object[] · required

Show child attributes

inputs · object[] · required

Show child attributes

outputs · object[] · required

Minimum array length: 1

Show child attributes

model · string · required

Minimum string length: 1

tags · object[] · required

Show child attributes

authorId · string | null

commitMessage · string | null

temperature · number

maxTokens · number

demonstrations · object

Show child attributes

promptingTechnique · object

Show child attributes

responseFormat · object

Show child attributes