v4

latestOpenAPI 3.0.1Apache 2.02026-08-016169702.3 MB
Project roles

Delete project role

Deletes a project role. You must specify a replacement project role if you wish to delete a project role that is in use.

Permissions required: Administer Jira global permission.

delete/rest/api/3/role/{id}

Path parameters

idinteger required

The ID of the project role to delete. Use Get all project roles to get a list of project role IDs.

Query parameters

swapinteger

The ID of the project role that will replace the one being deleted. The swap will attempt to swap the role in schemes (notifications, permissions, issue security), workflows, worklogs and comments.

Response

Returned if the request is successful.