> ## 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.
# Workspace ID
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.
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:**
```text theme={null}
https://app.tess.im/... ?w=12345
```
En este caso:
```text theme={null}
x_workspace_id: 12345
```
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`.
```text theme={null}
Authorization: Bearer SUA_API_KEY
x-workspace-id: 12345
```
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 importante**
En 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.