提交创建工作区任务

提交工作区创建任务。请求被接受后返回任务记录，工作区在后台创建。

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

调用前准备

先确定新工作区的名称。准备个人访问令牌。

请求体

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

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

参数

类型

是否必填

说明

name

string

是

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

成功响应

{
  "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

任务更新时间。

data.error_reason

string

失败原因说明。未设置时省略。

错误响应

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

字段

类型

说明

code

string

错误代码。

msg

string

可读错误信息。

data

null

错误响应中为 null。
最后更新于