Pular para o conteúdo principal
GET
/
agents
/
{id}
/
versions
/
{version_number}
Obter Versão do Agente
curl --request GET \
  --url https://api.tess.im/agents/{id}/versions/{version_number} \
  --header 'Authorization: Bearer <token>'

​
Exemplos de Código

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

​
Headers

​
x-workspace-id
integer
ID do workspace. Se não fornecido, o workspace selecionado pelo usuário será utilizado.
Nota: Este campo será obrigatório em uma versão futura da API. É altamente recomendado defini-lo agora para garantir compatibilidade com atualizações futuras.

​
Parâmetros de Caminho

​
id
integer
obrigatório
O ID do agente
​
version_id
integer
obrigatório
O ID da versão a ser consultada

​
Resposta

{
  "version": {
    "version_id": 7,
    "published_at": "2026-04-06T13:52:19+00:00",
    "published_by": "usuario@exemplo.com",
    "rollback_from_version": 2,
    "snapshot": {
      "agent_name": "Agente de Suporte ao Cliente",
      "instructions": "Você é um assistente de suporte ao cliente.",
      "ask_user_questions": [
        {
          "name": "topico",
          "type": "text",
          "description": "Sobre qual assunto você precisa de ajuda?",
          "required": true,
          "tooltip": ""
        }
      ],
      "steps": [],
      "knowledge_base_files": [],
      "type": "chat",
      "subtype": "All LLM Models",
      "advanced_settings": {
        "model": "auto",
        "temperature": "1"
      },
      "visibility": "private"
    }
  }
}

​
Campos da Resposta

CampoTipoDescrição
version.version_idintegerIdentificador sequencial único desta versão
version.published_bystringE-mail do usuário que salvou esta versão
version.published_atstring (ISO8601)Timestamp de quando esta versão foi criada
version.rollback_from_versioninteger | nullSe criada por um rollback, o version_id de origem; caso contrário null
version.snapshot.agent_namestringNome do agente no momento em que esta versão foi salva
version.snapshot.instructionsstringPrompt / instruções do sistema no momento em que esta versão foi salva
version.snapshot.ask_user_questionsarrayCampos de entrada do usuário configurados no momento em que esta versão foi salva
version.snapshot.stepsarraySteps de automação configurados no momento em que esta versão foi salva
version.snapshot.knowledge_base_filesarrayArquivos de base de conhecimento vinculados no momento em que esta versão foi salva
version.snapshot.typestringTipo do agente (ex: chat)
version.snapshot.subtypestringSubtipo do agente (ex: All LLM Models)
version.snapshot.advanced_settingsobjectConfigurações de modelo e temperatura no momento em que esta versão foi salva
version.snapshot.visibilitystringVisibilidade do agente (private ou public) no momento em que esta versão foi salva

​
Respostas de Erro

​
Não Encontrado (404)

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

​
Proibido (403)

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