---
title: "Delete Custom Role"
method: DELETE
path: "/custom_role/{custom_role_api_id}"
tags: ["Custom Roles"]
---

# Delete Custom Role

`DELETE /custom_role/{custom_role_api_id}`

This endpoint enables you to delete custom roles for organizations within your scope.

## Path parameters

- `custom_role_api_id` string, required

## Query parameters

- `org_id` integer

## Response `200`

OK

- CustomRoleDeletionResponse — Response for successfully deleting a custom role
  - `status` string
  - `api_id` string — API identifier of the deleted custom role

## Other responses

- `401` — You are not authenticated
- `403` — You are not allowed to perform this action
- `404` — Resource does not exist

---

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