Create project role

POST

/rest/api/3/role

Creates a new project role with no default actors. You can use the Add default actors to project role operation to add default actors to the project role after creating it.

Note that although a new project role is available to all projects upon creation, any default actors that are associated with the project role are not added to projects that existed prior to the role being created.<

Permissions required: Administer Jira global permission.

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'http:///rest/api/3/role' \
--header 'Content-Type: application/json' \
--data-raw '{
    "description": "A project role that represents developers in a project",
    "name": "Developers"
}'

响应示例

200 - 成功示例

{"self":"https://your-domain.atlassian.net/rest/api/3/project/MKY/role/10360","name":"Developers","id":10360,"description":"A project role that represents developers in a project"}

请求参数

Body 参数application/json

示例

返回响应

🟢200Returned if the request is successful.

application/json

Body

🟠400Returned if the request is not valid. The `name` cannot be empty or start or end with whitespace.

🟠401Returned if the authentication credentials are incorrect or missing.

🟠403Returned if the user does not have administrative permissions.

🟠409Returned if a project role with the provided name already exists.

修改于 2023-07-12 08:28:12

Get all project roles

Get project role by ID