Skip to main content
Bem-vindo à documentação da API da Tess AI! Este guia ajudará você a começar a usar nossa API e a entender como integrar os poderosos recursos da Tess AI em seus aplicativos.

URL base

Todas as solicitações à API devem ser feitas para a seguinte URL base:

Autenticação

Todas as solicitações de API exigem autenticação usando uma chave de API. Você pode obter sua chave de API no Painel de Controle do Tess AI. Para autenticar suas solicitações, inclua sua chave de API no cabeçalho Authorization:

Header de workspace

Requisições autenticadas da API devem incluir o header de contexto do workspace:
Obrigatório a partir de 01/09/2026 para execução de agentes e demais endpoints autenticados da API. Até lá, se omitido, a API usa o workspace selecionado do usuário (deprecated). Após a data, ausência → 422. Veja Errors.

Pontos de extremidade da API

A API Tess AI fornece as seguintes categorias principais de endpoints:

Agentes

Arquivos do Agente

Webhooks de Agentes

Workspaces

Eventos de auditoria

Memórias

Coleções de Memórias

Arquivos

Webhooks

Formato de Solicitação

A maioria dos endpoints de API aceita corpos de requisição codificados em JSON. Certifique-se de incluir o seguinte cabeçalho em suas requisições:

Formato de Resposta

Todas as respostas da API são retornadas em formato JSON. Uma resposta bem-sucedida normalmente terá um código de status HTTP 2xx e conterá os dados solicitados. Respostas de erro terão um código de status 4xx ou 5xx e incluirão uma mensagem de erro.