Workspaces

ワークスペースはテナンシーの境界です。データ（memory、プロジェクト、conversations、artifacts）、agent runs や生成が消費する課金残高、メンバーと API キーを所有します。ほぼすべてのエンドポイントがいずれかのワークスペースにスコープされます。

スコープのパターン

リソースエンドポイントはワークスペース配下にあり、あなたの API キーはただ一つのワークスペースに紐づきます：

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

あなたの workspace_id（UUID）はアプリの URL——/app/{workspace_id}/…——および Settings で確認できます。

ワークスペースの読み取り

GET/v1/workspaces/{workspace_id} —

ワークスペース（名前、プラン、あなたのロール）。

POST/v1/workspaces —

新しいワークスペースを作成します（通常はアプリ内で行います）。

bash

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

メンバーと招待

ワークスペースにはロールを持つメンバー（owner／admin／member／viewer）がいます。メンバーは招待リンクで追加され、ロールによって設定・課金・破壊的操作を管理できる者が決まります。プログラム的な連携では、通常メンバーセッションではなく API キーを使用します——認証を参照してください。

課金はワークスペース単位です：agent runs、生成、クラウドデスクトップの利用時間がワークスペース残高を消費します。run は budget_usd（run ごとの上限）とワークスペース残高の両方で制限されます。