---
title: "Delete ABAC attribute definition by ID"
slug: "delete-abac-attribute-definition-by-id"
updated: 2026-09-03T14:50:33Z
published: 2026-09-03T14:50:33Z
canonical: "developer.rocket.chat/delete-abac-attribute-definition-by-id"
---

> ## 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='b50748e7-aad9-4b5b-8a02-3b2db0c964b7'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='bf6d6004-0022-4b96-bf35-a83cea78d60b'>Success</option>
</select>Success

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

object  successboolean    

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='b37168aa-baf7-45be-a747-a5c14dab183d'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='43400373-548e-4f50-9109-31224fc67f05'>Attribute not found</option>
<option value='a1d4fb3b-d312-43a6-a093-42eec0b30436'>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='0139bd54-51fe-4088-8bae-6eeb620497bf'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='8c9c5366-52d7-4d36-9e88-e1a945b91e20'>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='4d2b6bd9-0dbc-4ef5-8400-38d99e6dddd9'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='3a5e57d6-75e2-49db-8fe0-080381ca02c6'>Missing required ABAC permissions</option>
</select>Missing required ABAC permissions

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

object  successboolean    
errorstring