Help Center/ CodeArts Build/ API Reference/ APIs/ Build Task Management/ Updating the Permissions Assigned to a Specific Role for a Build Task

Updated on 2025-12-09 GMT+08:00

Online Debugging

CLI Examples

View PDF

Updating the Permissions Assigned to a Specific Role for a Build Task

Function

This API is used to update the permissions assigned to a specific role for a build task.

Calling Method

For details, see Calling APIs.

URI

PUT /v1/job/role-permission

Request Parameters

**Table 1** Request body parameters
Parameter	Mandatory	Type	Description
job_id	No	String	Definition Build task ID. It includes digits and letters. To obtain this ID, open the page for editing the build task in your browser, and copy the 32-character string at the end of the URL. Constraints N/A. Range The 32-character string sits at the end of the URL and includes digits and letters. Default Value N/A.
role_id	No	String	Definition Role ID. Constraints N/A. Range N/A. Default Value N/A.
permission_name	No	String	Definition Permission name. Constraints N/A. Range ● is_modify: permission for modifying tasks ● is_delete: permission for deleting tasks ● is_view: permission for viewing tasks ● is_execute: permission for executing tasks ● is_copy: permission for cloning tasks ● is_forbidden: permission for disabling tasks ● is_manager: permission for managing tasks Default Value N/A.
permission_value	No	Boolean	Definition Whether to modify the permission. Constraints N/A. Range true or false Default Value true.

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
status	String	Definition API response status. Range ● success: The API call is successful. ● fail: The API call failed.
error	Object	Definition Error message. Range N/A.
result	String	Definition Data returned after the API is successfully called. Range N/A.

Example Requests

PUT https://{endpoint}/v1/job/role-permission

{
  "job_id" : "06ef6ad090b741aab13edc68d25f165a",
  "role_id" : "5",
  "permission_name" : "is_modify",
  "permission_value" : true
}