Workspaces

Workspace 是租用戶邊界。它擁有資料（memory、專案、conversations、artifacts）、agent runs 與生成所消耗的計費餘額，以及成員與 API key。幾乎每個端點都隸屬於某個 workspace 之下。

範圍模式

資源端點位於 workspace 之下，而你的 API key 恰好綁定至一個 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

可在應用程式 URL——/app/{workspace_id}/…——以及 Settings 中找到你的 workspace_id（一個 UUID）。

讀取 workspace

GET/v1/workspaces/{workspace_id} —

該 workspace（名稱、方案、你的角色）。

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 而非成員 session——參見驗證。

計費以 workspace 為單位：agent runs、生成與雲端桌面時間都會消耗 workspace 餘額。一次 run 同時受 budget_usd（每次 run 的上限）與 workspace 餘額約束。