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

Documentation Index

Fetch the complete documentation index at: https://docs.tess.im/llms.txt

Use this file to discover all available pages before exploring further.

Tentar fazer rollback para a versão atualmente ativa retorna um erro 422.

​
Exemplos de Código

curl --request POST \
  --url 'https://api.tess.im/agents/8794/versions/2/rollback' \
  --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 para a qual fazer rollback

​
Resposta

{
  "version": {
    "version_id": 10,
    "published_at": "2026-04-09T15:00:00+00:00",
    "published_by": "usuario@exemplo.com",
    "rollback_from_version": 8,
    "snapshot": {
      "agent_name": "Agente de Suporte ao Cliente",
      "instructions": "Você é um assistente de suporte ao cliente.",
      "ask_user_questions": [],
      "steps": [],
      "knowledge_base_files": [],
      "type": "chat",
      "subtype": "All LLM Models",
      "advanced_settings": {
        "model": "auto",
        "temperature": "1"
      },
      "visibility": "private"
    }
  },
  "message": "Agent rolled back to version 8. New version 10 is now active."
}

​
Campos da Resposta

CampoTipoDescrição
messagestringMensagem de confirmação indicando a versão de origem e a nova versão ativa
version.version_idintegerO novo ID de versão criado por este rollback
version.published_bystringE-mail do usuário que realizou o rollback
version.published_atstring (ISO8601)Timestamp de quando a versão de rollback foi criada
version.rollback_from_versionintegerO version_id utilizado como origem para este rollback
version.snapshotobjectEstado completo do agente restaurado por este rollback (mesma estrutura de Get Agent Version)

​
Respostas de Erro

​
Versão Já Ativa (422)

{
  "message": "Cannot roll back to the current active version."
}

​
Não Encontrado (404)

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

​
Proibido (403)

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