Skip to main content
GET
/
agents
/
{id}
/
versions
List Agent Versions
curl --request GET \
  --url https://api.tess.im/agents/{id}/versions \
  --header 'Authorization: Bearer <token>'

​
Code Examples

curl --request GET \
  --url 'https://api.tess.im/agents/8794/versions' \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
Headers

​
x-workspace-id
integer
ID of the workspace. If not provided, the user’s selected workspace will be used.
Note: This field will be required in a future release of the API. It is highly recommended to set it now to ensure compatibility with future updates.

​
Path Parameters

​
id
integer
required
The agent ID

​
Query Parameters

​
page
integer
Current page (default: 1)
​
per_page
integer
Number of items per page (default: 20)

​
Response

{
  "versions": [
    {
      "version_id": 9,
      "published_at": "2026-04-09T14:30:00+00:00",
      "published_by": "user@example.com",
      "rollback_from_version": 5,
      "change_summary": "",
      "diff": []
    },
    {
      "version_id": 7,
      "published_at": "2026-04-06T13:52:19+00:00",
      "published_by": "user@example.com",
      "rollback_from_version": 2,
      "change_summary": "instructions, ask_user_questions",
      "diff": {
        "instructions": {
          "previous_version": "You are a helpful assistant.",
          "current_version": "You are a helpful customer support assistant."
        },
        "ask_user_questions": {
          "previous_version": [],
          "current_version": [
            {
              "name": "topic",
              "type": "text",
              "description": "What topic do you need help with?",
              "required": true,
              "tooltip": ""
            }
          ]
        }
      }
    },
    {
      "version_id": 1,
      "published_at": "2026-04-02T17:52:17+00:00",
      "published_by": "user@example.com",
      "rollback_from_version": null,
      "change_summary": "",
      "diff": []
    }
  ],
  "current_version_number": 9,
  "meta": {
    "total": 9,
    "page": 1,
    "per_page": 20
  }
}

​
Response Fields

FieldTypeDescription
versionsarrayList of version entries for this agent
current_version_numberintegerThe version_id of the currently active version
meta.totalintegerTotal number of versions
meta.pageintegerCurrent page number
meta.per_pageintegerNumber of items per page
version_idintegerUnique sequential identifier for this version
published_bystringEmail of the user who saved this version
published_atstring (ISO8601)Timestamp when this version was created
rollback_from_versioninteger | nullIf this version was created by a rollback, the source version_id; otherwise null
change_summarystringComma-separated list of field names that changed relative to the previous version. Empty string when nothing changed
diffobject | arrayField-level diff vs. the previous version. Each key contains previous_version and current_version. Returns an empty array [] when there are no changes