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

​
Code Examples

curl --request GET \
  --url 'https://api.tess.im/agents/8794/versions/2' \
  --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
​
version_id
integer
required
The version ID to retrieve

​
Response

{
  "version": {
    "version_id": 7,
    "published_at": "2026-04-06T13:52:19+00:00",
    "published_by": "user@example.com",
    "rollback_from_version": 2,
    "snapshot": {
      "agent_name": "Customer Support Agent",
      "instructions": "You are a helpful customer support assistant.",
      "ask_user_questions": [
        {
          "name": "topic",
          "type": "text",
          "description": "What topic do you need help with?",
          "required": true,
          "tooltip": ""
        }
      ],
      "steps": [],
      "knowledge_base_files": [],
      "type": "chat",
      "subtype": "All LLM Models",
      "advanced_settings": {
        "model": "auto",
        "temperature": "1"
      },
      "visibility": "private"
    }
  }
}

​
Response Fields

FieldTypeDescription
version.version_idintegerUnique sequential identifier for this version
version.published_bystringEmail of the user who saved this version
version.published_atstring (ISO8601)Timestamp when this version was created
version.rollback_from_versioninteger | nullIf created by a rollback, the source version_id; otherwise null
version.snapshot.agent_namestringAgent name at the time this version was saved
version.snapshot.instructionsstringSystem prompt / instructions at the time this version was saved
version.snapshot.ask_user_questionsarrayUser input fields configured at the time this version was saved
version.snapshot.stepsarrayAutomation steps configured at the time this version was saved
version.snapshot.knowledge_base_filesarrayKnowledge base files linked at the time this version was saved
version.snapshot.typestringAgent type (e.g., chat)
version.snapshot.subtypestringAgent subtype (e.g., All LLM Models)
version.snapshot.advanced_settingsobjectModel and temperature settings at the time this version was saved
version.snapshot.visibilitystringAgent visibility (private or public) at the time this version was saved

​
Error Responses

​
Not Found (404)

{
  "message": "Version not found."
}

​
Forbidden (403)

{
  "message": "You do not have permission to view agent versions."
}