---
title: "Get ABAC attribute definition by ID"
slug: "get-abac-attribute-definition-by-id"
status: "update"
updated: 2026-09-15T13:59:24Z
published: 2026-09-15T13:59:24Z
canonical: "developer.rocket.chat/get-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.

# Get ABAC attribute definition by ID

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

- Retrieves a single ABAC attribute definition by ID.
- Returns the attribute key and its allowed values for the definition identified by `_id`.
- 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='3f0669b8-3883-46e3-8d3b-4a0794090581'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='f140a13e-e7da-4132-8d23-b4c1dacf25e0'>Success</option>
</select>Success

```json
{
  "success": true,
  "key": "my_department",
  "values": [
    "eng",
    "sales",
    "hr",
    "it"
  ]
}
```

object  successboolean    
keystring    
values Array of string   string    

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='67b01e6d-eae2-4e56-ae73-a4485d86f65e'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='0be28e37-0829-40da-8918-99ba71965568'>Attribute not found</option>
</select>Attribute not found

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

object  successboolean    
errorstring    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='9a9e8cee-98be-4c54-8da5-34eeb7066a94'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='f671298e-1e0d-4800-bcc0-a45ad8e1dfb9'>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='08e3fbef-885a-4500-af90-3b19b6c777a6'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='efd3beff-6689-405b-8e41-b5fcc51e9350'>Missing required ABAC permissions</option>
</select>Missing required ABAC permissions

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

object  successboolean    
errorstring