---
title: "Delete Custom Role"
method: DELETE
path: "/api/v1/roles/{role_id}"
tags: ["Team Management"]
---

# Delete Custom Role

`DELETE /api/v1/roles/{role_id}`

Deletes a custom role. System roles cannot be deleted, and a role that is still assigned to members or pending invites (or set as a default role) cannot be deleted. Requires a global API key.

## Response `200`

Role deleted successfully

- object
  - `success` boolean, required
  - `message` string, required

## Other responses

- `400` — Bad request - Invalid role ID format
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Global API key required, or the role is a system role
- `404` — Not found - Role does not exist in your organization
- `409` — Conflict - Role is still assigned to members or invites, or set as a default role
- `500` — Internal server error

---

[API](https://skmtc.net/athenahq/apis/athenahq-api.md) · [All operations](https://skmtc.net/athenahq/apis/athenahq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/athenahq/athenahq-api/revisions/6c5d71622cb9/schema)