---
title: "Deleting an existing Role"
method: DELETE
path: "/roles/{id}"
tags: ["Roles"]
---

# Deleting an existing Role

`DELETE /roles/{id}`

## Request

- Base URL: `https://api.mavenlink.com/api/v1`
- URL: `https://api.mavenlink.com/api/v1/roles/{id}`
- Auth: none declared

The Role will be soft-deleted if it is currently in use. If not, it will be removed.


The response will contain no content and an HTTP 204 status code if the request was
successful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.

## Path parameters

- `id` integer, required

## Response `204`

Role has been deleted.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized request
- `403`: Forbidden request
- `404`: Page Not Found
- `422`: Unprocessable Entity
- `503`: Service is unavailable

---

[API](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation.md) - [All operations](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/revisions/9d4ebed2fa98?raw)