Workspaces

Un workspace es la frontera de tenencia. Posee los datos (memory, projects, conversations, artifacts), el saldo de facturación que gastan las agent runs y la generación, y los miembros y API keys. Casi todos los endpoints se acotan bajo uno.

El patrón de acotado

Los endpoints de recursos viven bajo el workspace, y tu API key está vinculada exactamente a un 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

Encuentra tu workspace_id (un UUID) en la URL de la app (/app/{workspace_id}/…) y en Settings.

Leer un workspace

GET/v1/workspaces/{workspace_id} —

el workspace (nombre, plan, tu rol).

POST/v1/workspaces —

crea un workspace nuevo (suele hacerse en la app).

bash

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

Miembros e invitaciones

Los workspaces tienen miembros con roles (owner / admin / member / viewer). Los miembros se añaden por enlace de invitación, y los roles controlan quién puede gestionar settings, facturación y acciones destructivas. Para integraciones programáticas sueles usar una API key en lugar de una sesión de miembro; consulta Authentication.

La facturación es por workspace: las agent runs, la generación y el tiempo de escritorio cloud consumen del saldo del workspace. Una run está limitada tanto por budget_usd (un techo por run) como por el saldo del workspace.