---
title: "Delete project role"
method: DELETE
path: "/rest/api/3/role/{id}"
tags: ["Project roles"]
---

# Delete project role

`DELETE /rest/api/3/role/{id}`

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

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Path parameters

- `id` integer, required

## Query parameters

- `swap` integer

## Response `204`

Returned if the request is successful.

## Other responses

- `400` — Returned if the request is invalid or if the replacement project role is not found.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have administrative permissions.
- `404` — Returned if the project role being deleted is not found.
- `409` — Returned if the project role being deleted is in use and a replacement project role is not specified in the request.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/ec7f275dfee5/schema)