文档首页/ 代码托管 CodeArts Repo/ API参考（联盟区域）/ API/ V2Project/ 创建项目并fork仓库
更新时间：2026-01-08 GMT+08:00
查看PDF
分享

创建项目并fork仓库

功能介绍

创建仓库后fork仓库 传入参数：仓库名、是否导入项目成员、归属项目

URI

POST /v2/projects/repositories/fork

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表2 请求Body参数

参数

是否必选

参数类型

描述

import_members

否

Integer

是否导入项目成员，取值范围：0->不导入项目成员，1->导入项目成员

project_name

是

String

项目名称，取值范围：可以输入英文大小写字母、数字、连字符、下划线，且必须以字母开头

repo_name

是

String

仓库名称，取值范围：可以输入英文大小写字母、数字、连字符、下划线，且必须以字母开头

最小长度：2

最大长度：128

template_id

是

String

复制模板的ID

type

否

String

项目类型，scrum

visibility_level

否

Integer

仓库可见性： *私有仓库：仓库仅对仓库成员可见，仓库成员可读写和访问仓库，取值范围为0 *公开仓库：1.项目内成员只读仓库：仓库对项目内成员公开只读，并项目内成员可在项目下和代码组下的仓库列表中查看和搜索，取值范围为10 2.租户内成员只读仓库：仓库对租户内成员公开只读，并租户内成员可在项目下和代码组下的仓库列表中查看和搜索，取值范围为10 3.所有访客只读仓库：仓库对所有访客公开只读，并所有访客可在项目下和代码组下的仓库列表中查看和搜索，取值范围为20

external_project_info

否

ExternalKeyMessage object

第三方服务信息
表3 ExternalKeyMessage

参数

是否必选

参数类型

描述

external_key_message

否

String

第三方保存在代码托管的关键信息

external_service

否

String

外部服务名称

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

error

Error object

响应错误

result

ProjectRepository object

响应结果

status

String

响应状态
表5 Error

参数

参数类型

描述

code

String

错误码

message

String

错误信息
表6 ProjectRepository

参数

参数类型

描述

projectUuid

String

项目ID，获取方式请参见获取项目ID。

最小长度：32

最大长度：32

repositoryUuid

String

仓库UUID

最小长度：32

最大长度：32

请求示例

POST https://{endpoint}/v2/projects/{project_uuid}/repositories/fork

{
  "project_name" : "testworld",
  "repo_name" : "demotest1",
  "template_id" : 453489,
  "import_members" : 0,
  "visibility_level" : 20,
  "type" : "normal"
}

响应示例

状态码： 200

OK

{
  "result" : {
    "repositoryUuid" : "9a780fd55cd64333b668ba26132629d2",
    "projectUuid" : "278a03286efe45c6b788122bfc166976"
  },
  "status" : "success"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： V2Project