Workspaces

Workspace 是租户边界。它拥有数据（Memory、Projects、Conversations、artifacts）、agent 运行与生成所消耗的计费余额，以及成员和 API key。几乎所有端点都挂在其下。

作用域模式

资源端点都位于工作区之下，而你的 API key 绑定到唯一一个工作区：

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

在应用 URL 中——/app/{workspace_id}/…——以及“设置”中可以找到你的 workspace_id（一个 UUID）。

读取 Workspace

GET/v1/workspaces/{workspace_id} —

工作区信息（名称、套餐、你的角色）。

POST/v1/workspaces —

创建一个新 Workspace（通常在应用中完成）。

bash

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

成员与邀请

Workspace 有带角色的成员（owner / admin / member / viewer）。成员通过邀请链接加入，角色决定谁可以管理设置、计费和破坏性操作。对于编程式集成，你通常使用 API key 而非成员会话——参见身份验证。

计费按工作区进行：agent 运行、生成以及云桌面时长都会消耗工作区余额。一次运行同时受 budget_usd（单次运行上限）和工作区余额的约束。