工作空间 API

工作空间是组织内项目协作的运营容器，管理成员、预算和项目集合。

创建工作空间

POST /api/v1/workspaces
Authorization: Bearer <token>
Content-Type: application/json

{
  "name": "Backend Team",
  "organization_id": "uuid",
  "description": "后端服务开发",
  "budget_monthly_limit_usd": 500,
  "budget_alert_threshold": 0.8
}

列出工作空间

GET /api/v1/workspaces
Authorization: Bearer <token>

返回当前用户可访问的工作空间。

获取工作空间

GET /api/v1/workspaces/{workspace_id}
Authorization: Bearer <token>

更新工作空间

需要 workspace:settings 权限。

PUT /api/v1/workspaces/{workspace_id}
Authorization: Bearer <token>
Content-Type: application/json

{
  "name": "Backend Services",
  "description": "更新描述"
}

成员管理

列出成员

GET /api/v1/workspaces/{workspace_id}/members
Authorization: Bearer <token>

添加成员

POST /api/v1/workspaces/{workspace_id}/members
Authorization: Bearer <token>
Content-Type: application/json

{
  "email": "dev@example.com",
  "role": "developer"
}

工作空间角色：owner、admin、developer、viewer。

更新角色

PUT /api/v1/workspaces/{workspace_id}/members/{member_user_id}
Authorization: Bearer <token>
Content-Type: application/json

{
  "role": "admin"
}

移除成员

DELETE /api/v1/workspaces/{workspace_id}/members/{member_user_id}
Authorization: Bearer <token>

转移所有者

POST /api/v1/workspaces/{workspace_id}/transfer-ownership
Authorization: Bearer <token>
Content-Type: application/json

{
  "new_owner_id": "uuid"
}

审计日志

GET /api/v1/workspaces/{workspace_id}/audit-logs?page=1&page_size=20
Authorization: Bearer <token>