Evose

API · Workspace

列表 · 创建 · 修改 · 删除 · 成员管理

Workspace API

空间的增删查改与成员管理。

列出空间

GET /v1/workspaces

参数:

参数说明
limit默认 20
cursor分页
statusactive / archived

响应:

{
  "data": [
    {
      "id": "ws-001",
      "name": "客服团队",
      "description": "客服机器人 + FAQ 知识库",
      "type": "team",
      "owner_id": "u-001",
      "member_count": 12,
      "status": "active",
      "created_at": "2026-01-15T10:00:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

创建空间

POST /v1/workspaces

请求:

{
  "name": "营销团队",
  "description": "...",
  "type": "team",
  "join_policy": "approve_required"
}

获取详情

GET /v1/workspaces/{id}

更新

PATCH /v1/workspaces/{id}
{ "name": "新名称", "description": "..." }

删除

DELETE /v1/workspaces/{id}

删除是不可逆的

所有内部 Agent / Workflow / 知识库 / 工具配置失效。请先备份。

成员管理

列出成员

GET /v1/workspaces/{id}/members

添加成员

POST /v1/workspaces/{id}/members
{
  "user_id": "u-005",
  "role": "developer"
}
角色值含义
admin空间管理员
developer应用搭建者
user普通用户
readonly只读

移除成员

DELETE /v1/workspaces/{id}/members/{user_id}

转让所有权

POST /v1/workspaces/{id}/transfer
{ "new_owner_id": "u-002" }

仅当前所有者能调用。

接下来

页面导航