---
title: "Delete ABAC attribute definition by ID"
slug: "delete-abac-attribute-definition-by-id"
updated: 2026-06-08T12:46:40Z
published: 2026-06-08T12:46:40Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete ABAC attribute definition by ID

Delete/api/v1/abac/attributes/:_id![Defense](https://raw.githubusercontent.com/RocketChat/Rocket.Chat-Open-API/main/images/Defense.svg)

- Deletes an ABAC attribute definition by ID.
- Removes the attribute definition identified by `_id`. The delete fails if the attribute is currently in use, for example assigned to any room.
- Requires the `abac-management` and `manage-abac-admin-room-attributes` permissions.

### Changelog

| Version | Description |
| --- | --- |
| 8.0.0 | Added |
| 8.5.0 | Added the `manage-abac-admin-room-attributes` granular permission requirement. |

Header parametersX-Auth-TokenstringRequired

The `authToken` of the authenticated user.

ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-IdstringRequired

The `userId` of the authenticated user.

ExamplerbAXPnMktTFbNpwtJ

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='3a1ed54d-bf0b-4f23-aa15-d41b06ee73c6'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='a7e931c2-3881-4c15-ae90-2e36832cf8af'>Success</option>
</select>Success

```json
{
  "success": true
}
```

object  successboolean    

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='f80d86f4-8b92-4b29-92a5-ade85f4a81f8'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='60c72d67-9be2-44b3-9739-c65acb512414'>Attribute not found</option>
<option value='9e4a4987-916d-4e0d-ad78-eae5d3d5a0d6'>Attribute in use</option>
</select>Attribute not found

```json
{
  "success": false,
  "error": "error-attribute-not-found"
}
```

Attribute in use

```json
{
  "success": false,
  "error": "error-attribute-in-use"
}
```

object  successboolean    
errorstring    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='e15a4572-0bcf-4a0a-946e-94b1273bbbca'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='02c3c8b8-33ec-4c06-b119-f5b464446ede'>Unauthorized login attempt</option>
</select>Unauthorized login attempt

```json
{
  "success": false,
  "error": "error-unauthorized"
}
```

object  successboolean    
errorstring    

403

Forbidden

<select class='api-response-data' aria-label='Media type'><option value='4a99c655-b04a-4b8c-89cd-af2ad635a22a'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='10ab7dc2-c92e-4b85-a8bc-3cb440cc2609'>Missing required ABAC permissions</option>
</select>Missing required ABAC permissions

```json
{
  "success": false,
  "error": "error-not-authorized"
}
```

object  successboolean    
errorstring