---
title: "Check if ABAC attribute is in use"
slug: "check-if-abac-attribute-is-in-use"
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.

# Check if ABAC attribute is in use

Get/api/v1/abac/attributes/:key/is-in-use![Defense](https://raw.githubusercontent.com/RocketChat/Rocket.Chat-Open-API/main/images/Defense.svg)

- Checks whether an ABAC attribute definition is currently used by 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='1393f737-f16c-4ab3-acc4-0d6a4399cc2f'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='af89f295-2c25-42f1-b124-6bd780240658'>Success</option>
</select>Success

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

object  successboolean    
inUseboolean    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='b755c42e-3c1c-4264-9d3e-bd4c4588962c'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='f6b64909-4529-4c97-a66d-ab58642f2626'>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='8a755fa0-552b-4e60-bae5-b52b57733d37'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='77648f2b-4ed0-4287-b414-b6fa796ad5fb'>Missing required ABAC permissions</option>
</select>Missing required ABAC permissions

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

object  successboolean    
errorstring