认领工作区¶

检查当前用户是否已加入指定工作区。此接口不会创建工作区、添加成员或转移工作区所有权。

POST https://api.moi.matrixorigin.cn/v5/workspaces/claim

调用前准备¶

先确认当前身份已是目标工作区的成员。准备个人访问令牌和目标工作区 ID。认领对象只能是当前调用身份，不能指定其他用户。

请求体¶

将 $AI_STUDIO_API_KEY 和 $WORKSPACE_ID 替换为实际值。

输入示例

curl -X POST "https://api.moi.matrixorigin.cn/v5/workspaces/claim" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "'"$WORKSPACE_ID"'"
  }'

参数说明

参数	类型	是否必填	说明
`workspace_id`	string	是	要认领的工作区 ID。

成功响应¶

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "workspace_id": "ws_01",
    "claimed": false,
    "already_claimed": true
  }
}

字段说明

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data.workspace_id`	string	已检查成员关系的工作区 ID。
`data.claimed`	boolean	固定为 `false`。此接口不转移工作区所有权。
`data.already_claimed`	boolean	固定为 `true`。已有成员即使不是所有者，也可能返回此值。

错误响应¶

响应示例

{
  "code": "ErrWorkspaceNotFound",
  "msg": "工作区不存在",
  "data": null
}

字段说明

字段	类型	说明
`code`	string	错误代码。
`msg`	string	可读错误信息。
`data`	null	错误响应中为 `null`。

最后更新于 2026 年 10 月 19 日