提交创建工作区任务

提交一条异步创建工作区任务。请求被接受后立即返回任务记录，不会在本次响应中等待工作区创建完成。

当前控制台创建工作区时使用本接口。需要同步等待创建结果时，使用创建工作区。

POST https://moi.matrixorigin.cn/newmoi/workspaces/creations

调用前准备

先确定新工作区的名称。准备个人访问令牌。此接口不需要先进入某个工作区。

请求体

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

curl -X POST "https://moi.matrixorigin.cn/newmoi/workspaces/creations" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "'"$WORKSPACE_NAME"'"
  }'

参数

类型

是否必填

说明

name

string

是

要创建的工作区名称。去除首尾空白后不能为空。

成功响应

成功时返回 202。data 是本次提交的创建任务，不是已完成的工作区。

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "id": "creation_01",
    "name": "分析工作区",
    "status": "pending",
    "created_at": "2026-08-28T09:00:00Z",
    "updated_at": "2026-08-28T09:00:00Z"
  }
}

字段

类型

说明

code

string

成功时为 OK。

msg

string

成功时为 OK。

data.id

string

创建任务 ID。

data.name

string

要创建的工作区名称。

data.status

string

任务状态：pending、running、succeeded、failed 或 cleanup_pending。

data.workspace_id

string

已创建的工作区 ID；尚未创建成功时省略。

data.error_code

string

失败时的错误代码；未失败时省略。

data.created_at

string

任务创建时间。

data.updated_at

string

任务更新时间。

错误响应

{
  "code": "ErrParamInvalid",
  "msg": "名称不能为空",
  "data": null
}

字段

类型

说明

code

string

错误代码。

msg

string

可读错误信息。

data

null

错误响应中为 null。

后续操作

用查看创建工作区任务跟踪任务状态。状态为 succeeded 且出现 workspace_id 后，再查看工作区列表确认该工作区可访问。

最后更新于