Skip to main content
El Workspace ID es el identificador único de tu espacio de trabajo en Tess. Es necesario en todas las llamadas a la API de Tess, incluyendo integraciones hechas con N8n, Zapier, Make, Power Automate, códigos en HTML/JavaScript o cualquier otra herramienta que envíe solicitudes HTTP. Este identificador se envía en el header x-workspace-id e informa desde qué workspace parte la solicitud. En la práctica, define de dónde se consumirán los créditos de la ejecución.
El Workspace Id no funciona como un filtro, puedes localizar cualquier agente público en la API que esté disponible en Tess y que se encuentre en otros Workspaces.

​
¿Qué es?

Todo usuario de Tess está vinculado a uno o más workspaces: espacios donde se organizan agentes, automatizaciones, miembros y créditos. El Workspace ID es el código numérico que identifica cada uno de estos entornos de forma única. Cada vez que haces una llamada a la API de Tess —ya sea directamente por código o mediante una plataforma integradora— envía el Workspace ID en el header x-workspace-id. Tess usa este valor para identificar:
  • El workspace de origen de la solicitud;
  • El workspace asociado a la API Key utilizada;
  • El workspace del que se descontarán los créditos de la ejecución.
Importante:El x-workspace-id no limita qué agentes pueden ejecutarse. Puedes ejecutar agentes públicos de otros workspaces, siempre que tengas acceso a ellos. En ese caso, la llamada sigue partiendo de tu workspace y los créditos se consumen de él.

​
Dónde encontrarlo

Para localizar el Workspace ID del entorno actual:
  1. En Tess, abre Configuraciones.
  2. Haz clic en Workspace.
  3. Ubica el campo Workspace ID.
  4. Copia solo el número indicado.
Esta es la forma recomendada, ya que evita confusiones cuando tienes acceso a más de un workspace.
Captura De Tela 2026 07 21 Às 11 37 55 1
Hay una opción alternativa, identificándolo a través de la URL, pero se necesita atención para que no haya ningún error:
  • Observa la barra de direcciones del navegador y ubica el parámetro w=. El número justo después de ese parámetro es el Workspace ID.

    Ejemplo:
En este caso:
Al usar la URL, confirma que estás navegando en el workspace correcto antes de copiar el valor.

​
Aplicándolo en la API

Incluye el Workspace ID en el header x-workspace-id en toda solicitud enviada a la API de Tess. Además de él, incluye también tu API Key en el header Authorization.
Esto se aplica a llamadas realizadas desde:
  • Tu propio código, como HTML, JavaScript, Python u otros lenguajes;
  • Herramientas de prueba de API, como Postman o Insomnia;
  • Plataformas de automatización, como N8n, Zapier, Make y Power Automate;
  • Sistemas internos, CRMs, backends e integraciones personalizadas.
En plataformas integradoras, configura estos valores manualmente en la sección de Headers del módulo o paso de solicitud HTTP. Después, envía los demás parámetros de la llamada, como el agent_id y el prompt que será procesado por el agente.

​
Buenas prácticas

  • Incluye el x-workspace-id en todas las solicitudes a la API de Tess.
  • Prioriza la consulta en Configuraciones > Workspace para copiar el ID correcto.
  • Copia solo el número del Workspace ID, sin espacios ni caracteres adicionales.
  • Usa siempre el Workspace ID asociado a la API Key configurada en la integración.
  • En automatizaciones con múltiples agentes, mantén el mismo x-workspace-id cuando las llamadas partan del mismo workspace.
  • Almacena la API Key en variables de entorno, bóvedas de credenciales o campos seguros de la plataforma integradora.
  • Nunca compartas tu API Key en prompts, mensajes, repositorios públicos o capturas de pantalla.
Observación importanteEn cualquier integración con la API de Tess, envía el x-workspace-id junto con tu API Key. Este header identifica el workspace de origen de la llamada y garantiza que los créditos se contabilicen correctamente —ya sea en tu propio código, en N8n, Zapier, Make u otra herramienta de automatización.