---
title: "DELETE /v2/roles/{role_id}"
method: DELETE
path: "/v2/roles/{role_id}"
tags: ["roles"]
---

# DELETE /v2/roles/{role_id}

`DELETE /v2/roles/{role_id}`

Delete a single Role

## Path parameters

- `role_id` string, required

## Headers

- `cloudzero-test-key` string

## Response `200`

Successful Operation

- object
  - `role` WithId
    - `id` string, required

## Other responses

- `400` — Bad Request Error
- `403` — Forbidden
- `404` — Not Found Error

---

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