Workspaces

Um workspace é a fronteira de tenancy. Ele possui os dados (memória, projetos, conversas, artifacts), o saldo de cobrança que agent runs e geração consomem, e os membros e chaves de API. Quase todo endpoint tem escopo sob um.

O padrão de escopo

Endpoints de recursos vivem sob o workspace, e sua chave de API está vinculada a exatamente um workspace:

text

/v1/workspaces/{workspace_id}/memory
/v1/workspaces/{workspace_id}/projects
/v1/workspaces/{workspace_id}/conversations
/v1/workspaces/{workspace_id}/agent/runs
/v1/workspaces/{workspace_id}/api-keys

Encontre seu workspace_id (um UUID) na URL do app — /app/{workspace_id}/… — e em Settings.

Ler um workspace

GET/v1/workspaces/{workspace_id} —

o workspace (nome, plano, seu papel).

POST/v1/workspaces —

cria um novo workspace (geralmente feito no app).

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE \
  -H "Authorization: Bearer $NEXEVO_API_KEY"

Membros e convites

Workspaces têm membros com papéis (owner / admin / member / viewer). Membros são adicionados por link de convite, e os papéis controlam quem pode gerenciar configurações, cobrança e ações destrutivas. Para integrações programáticas você tipicamente usa uma chave de API em vez de uma sessão de membro — veja Autenticação.

A cobrança é por workspace: agent runs, geração e tempo de desktop na nuvem consomem do saldo do workspace. Um run é limitado tanto por budget_usd (um teto por run) quanto pelo saldo do workspace.