List an experiment's versions

Every saved version of the experiment’s setup, newest first. A commit, an agent write and a restore each add a numbered version. Ordinary typing rewrites one autosave row, which is the entry with autoSaved true. Page through them with limit and cursor.

GET /api/v1/experiments/{slug}/versions

List an experiment's versions

Python

import requests

url = "https://app.langwatch.ai/api/v1/experiments/{slug}/versions"

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

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

print(response.text)

200

{
  "versions": [
    {
      "version": 0,
      "counterVersion": 0,
      "autoSaved": true,
      "commitMessage": "<string>",
      "authorLabel": "user",
      "authorId": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ],
  "nextCursor": 0
}

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

slug · string · required

The experiment's slug, or its id

Minimum string length: 1

Query Parameters

limit · integer

Versions per page, capped at 100

Required range: x <= 9007199254740991

cursor · integer

The nextCursor of the previous page

Required range: x <= 9007199254740991

Response

200

application/json

Success

versions · object[] · required

Newest first, by counterVersion

Show child attributes

nextCursor · integer | null · required

Pass as cursor to read the next page, null on the last one

Required range: -9007199254740991 <= x <= 9007199254740991