Workspaces

워크스페이스는 테넌시 경계입니다. 데이터(memory, project, conversation, artifact), agent run과 생성이 소비하는 결제 잔액, 그리고 멤버와 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)을 가진 멤버가 있습니다. 멤버는 초대 링크로 추가되며, 역할은 누가 settings, 결제, 파괴적 액션을 관리할 수 있는지를 제어합니다. 프로그래밍 방식 통합에서는 일반적으로 멤버 세션 대신 API 키를 사용합니다. Authentication을 참고하세요.

결제는 워크스페이스 단위입니다. agent run, 생성, 클라우드 데스크톱 시간이 워크스페이스 잔액에서 차감됩니다. run은 budget_usd(run당 상한)과 워크스페이스 잔액 모두의 제한을 받습니다.