Updating the Repository Permission Inheritance Configuration

This API is used to update the repository permission inheritance configuration.

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

PUT https://{hostURL}/v4/repositories/{repository_id}/permission-inherit-setting

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
repository_id	Yes	Integer	Definition You can query the project list to obtain the repository ID by calling the API used to query user's all repositories. Constraints N/A. Value range: 1~2147483647

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition User token. Obtain a token by calling the IAM API for obtaining a user token. The value of X-Subject-Token in the response header is the user token. Constraints Mandatory. Range 1–100,000 characters. Default Value N/A.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
inherit_parent_permission	Yes	Boolean	Definition Permission inheritance settings. Constraints N/A. Range true, the upper-layer permission configuration is used. If the upper-layer is a repository group, the repository group permission configuration is used. If the upper-layer is a project, the project permission configuration is used. false, the repository permission configuration is used.

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
inherit_parent_permission	Boolean	Definition Permission inheritance settings. Constraints N/A. Range true, the upper-layer permission configuration is used. If the upper-layer is a repository group, the repository group permission configuration is used. If the upper-layer is a project, the project permission configuration is used. false, the repository permission configuration is used.

Status code: 401

**Table 5** Response body parameters
Parameter	Type	Description
error_code	String	Definition Error code.
error_msg	String	Definition Error message.

Status code: 403

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	Definition Error code.
error_msg	String	Definition Error message.

Status code: 404

**Table 7** Response body parameters
Parameter	Type	Description
error_code	String	Definition Error code.
error_msg	String	Definition Error message.

PUT https://{endpoint}/v4/repositories/100000/permission-inherit-setting

{
  "inherit_parent_permission" : true
}

Status code: 200

{
  "inherit_parent_permission" : true
}

Status code: 401

Unauthorized

{
  "error_code" : "DEV.00000003",
  "error_msg" : "Authentication information expired."
}

Status code: 403

Bad Request

{
  "error_code" : "CH.004403",
  "error_msg" : "Insufficient permissions. Apply for the required permission and try again."
}

Status code: 404

Not Found

{
  "error_code" : "CH.004404",
  "error_msg" : "Group Not Found"
}

Parent topic: Permission

Thank you very much for your feedback. We will continue working to improve the documentation.

The system is busy. Please try again later.