認証

Nexevo API は、ワークスペースに紐づく API キーで認証を行い、Bearer トークンとして送信します。

ヘッダー

リクエストごとに Authorization ヘッダーでキーを送信します：

http

Authorization: Bearer sk-ws-...

キーが無い・無効・ワークスペースが一致しない場合は 401 が返ります。

キーはワークスペーススコープ

各キーはただ一つのワークスペースに属します。リソースエンドポイントは /v1/workspaces/{workspace_id}/… 配下にあり、キーのワークスペースがパスの {workspace_id} と一致する必要があります——あるキーが別のワークスペースのデータに届くことはありません。複数のワークスペースを扱うには、ワークスペースごとにキーを作成してください。

キーの管理

キーの作成・一覧・失効はアプリ（Settings → API keys）または API から行えます：

POST/v1/workspaces/{workspace_id}/api-keys —

キーを作成します。シークレットはレスポンスで一度だけ返されます；安全に保管してください。

GET/v1/workspaces/{workspace_id}/api-keys —

キーを一覧表示します（メタデータのみ——シークレットは含みません）。

DELETE/v1/workspaces/{workspace_id}/api-keys/{key_id} —

キーを即座に失効させます。

bash

# Create a key
curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/api-keys \
  -H "Authorization: Bearer $EXISTING_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "production-backend"}'

キーはワークスペースへの完全なアクセス権を付与します——Memory の読み書き、エージェントの実行（ワークスペース残高を消費）など。キーはサーバーに保管し、環境ごとに 1 つ設定し、漏洩のおそれがあるキーは直ちに失効させてください。

セッションと API キー

Web アプリはログインセッション（Cookie）でユーザーを認証します；これは UI 用のものです。プログラム的なアクセス——バックエンド、スクリプト、連携——には、セッションではなく常に API キーを使用してください。