> ## 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

O **Workspace ID** é o identificador único do seu espaço de trabalho na Tess. Ele é necessário em **todas as chamadas à API da Tess**, incluindo integrações feitas com N8n, Zapier, Make, Power Automate, códigos em HTML/JavaScript ou qualquer outra ferramenta que envie requisições HTTP.

Esse identificador é enviado no header `x-workspace-id` e informa de qual workspace a requisição parte. Na prática, ele define **de onde os créditos da execução serão consumidos**.

<Info>
  O Workspace Id não funciona como um filtro, você pode localizar qualquer agente público na API que está disponível na Tess e que estejam em outros Workspaces.
</Info>

### O que é?

Todo usuário da Tess está vinculado a um ou mais **workspaces**: espaços onde agentes, automações, membros e créditos são organizados.

O **Workspace ID** é o código numérico que identifica cada um desses ambientes de forma única.

Sempre que você faz uma chamada à API da Tess — seja diretamente por código ou por uma plataforma integradora — envie o Workspace ID no header `x-workspace-id`.

A Tess usa esse valor para identificar:

* O workspace de origem da requisição;
* O workspace associado à API Key utilizada;
* O workspace de onde os créditos da execução serão descontados.

<Note>
  **Importente:**

  O `x-workspace-id` **não limita quais agentes podem ser executados**. Você pode executar agentes públicos de outros workspaces, desde que tenha acesso a eles. Nesse caso, a chamada continua partindo do seu workspace e os créditos são consumidos dele.
</Note>

## Onde encontrar

Para localizar o Workspace ID do ambiente atual:

1. Na Tess, abra as **Configurações**.
2. Clique em **Workspace**.
3. Localize o campo **Workspace ID**.
4. Copie apenas o número informado.

Essa é a forma recomendada, pois evita confusões quando você tem acesso a mais de um workspace.

<Frame>
  <img src="https://mintcdn.com/tess-dfe1edf0/8HOZCd-luP-z1qbl/images/Captura-de-Tela-2026-07-21-a%CC%80s-11.37.55.png?fit=max&auto=format&n=8HOZCd-luP-z1qbl&q=85&s=ed5a90add2b201b5a5e7a2b503ed84e3" alt="Captura De Tela 2026 07 21 Às 11 37 55" width="1928" height="1104" data-path="images/Captura-de-Tela-2026-07-21-às-11.37.55.png" />
</Frame>

<Note>
  Há uma opção alternativa, identificando via URL, mas precisa de atenção para que não haja nenhum erro:

  * Observe a barra de endereços do navegador e localize o parâmetro `w=`. O número logo após esse parâmetro é o Workspace ID.<br /><br />**Exemplo:**

  ```text theme={null}
  https://app.tess.im/... ?w=12345
  ```

  Ao usar a URL, confirme que você está navegando no workspace correto antes de copiar o valor.
</Note>

## Aplicando na API

Inclua o Workspace ID no header `x-workspace-id` em **toda requisição enviada à API da Tess**.

Além dele, inclua também sua API Key no header `Authorization`.

```text theme={null}
Authorization: Bearer SUA_API_KEY
x-workspace-id: 12345
```

Isso se aplica a chamadas realizadas por:

* Código próprio, como HTML, JavaScript, Python ou outras linguagens;
* Ferramentas de teste de API, como Postman ou Insomnia;
* Plataformas de automação, como **N8n, Zapier, Make** e Power Automate;
* Sistemas internos, CRMs, backends e integrações personalizadas.

Em plataformas integradoras, configure esses valores manualmente na seção de **Headers** do módulo ou etapa de requisição HTTP.

Depois, envie os demais parâmetros da chamada, como o `agent_id` e o `prompt` que será processado pelo agente.

## Boas práticas

* Inclua o `x-workspace-id` em todas as requisições à API da Tess.
* Priorize a consulta em **Configurações > Workspace** para copiar o ID correto.
* Copie apenas o número do Workspace ID, sem espaços ou caracteres adicionais.
* Use sempre o Workspace ID associado à API Key configurada na integração.
* Em automações com múltiplos agentes, mantenha o mesmo `x-workspace-id` quando as chamadas partirem do mesmo workspace.
* Armazene a API Key em variáveis de ambiente, cofres de credenciais ou campos seguros da plataforma integradora.
* Nunca compartilhe sua API Key em prompts, mensagens, repositórios públicos ou capturas de tela.

<Warning>
  **Observação importante**

  Em qualquer integração com a API da Tess, envie o `x-workspace-id` junto à sua API Key. Esse header identifica o workspace de origem da chamada e garante que os créditos sejam contabilizados corretamente — seja em um código próprio, no N8n, Zapier, Make ou outra ferramenta de automação.
</Warning>