API 参考工作区

创建工作区

POST/projects/{project_id}/workspaces/

在项目沙箱中创建工作区，或创建 Git 绑定的工作区。

参数

请求体字段	必填	说明
name	必填	显示名
type	必填	local（沙箱目录）或 git（绑定 GitLab/GitHub）
slug	可选	目录名——缺省自动生成，创建后永久不变
path_mode	local 必填	local 工作区的 shared 或 tmp
provider / repo_url / token / default_branch	git 必填	Git 仓库绑定
artifact_type	可选	knowledge_base 把工作区变为 OKF 知识库

请求

curl -X POST "$ALLYBUILD_API_URL/projects/$PROJECT_ID/workspaces/" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"
  -d '{"name": "Docs", "type": "local", "path_mode": "shared"}'

响应

{
  "id": "2b1a9f8e-...",
  "name": "Docs",
  "slug": "docs",
  "type": "local",
  "path_mode": "shared"
}