---
title: "Add ABAC attribute key to room"
slug: "add-abac-attribute-key-to-room"
status: "update"
updated: 2026-09-15T13:58:46Z
published: 2026-09-15T13:58:46Z
canonical: "developer.rocket.chat/add-abac-attribute-key-to-room"
---

> ## 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.

# Add ABAC attribute key to room

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

- Adds a single ABAC attribute key to a room.
- Creates a new ABAC attribute on the specified room for the given key, assigning it the provided values array; fails if the room already has this key or if the key/values are not allowed by the global attribute definition.
- Requires the ABAC license, the `abac-management` and `manage-abac-admin-rooms` permissions, and the global setting `ABAC_Enabled` to be turned on.

### Changelog

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

Header parametersX-Auth-TokenstringRequired

The `authToken` of the authenticated user.

ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-IdstringRequired

The `userId` of the authenticated user.

ExamplerbAXPnMktTFbNpwtJ

Body parameters

- Values (array of strings, required): The attribute values to assign for this key.
- Must have at least 1 item, max 10 items, and all values must be unique.

<select class='api-response-data' aria-label='Media type'><option value='0bb40b69-8b1e-4796-9154-37486b30a33d'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='bee3fe0e-c3e5-4360-a127-5203b2c15b4f'>Example 1</option>
</select>Example 1

```json
{
  "values": [
    "asia"
  ]
}
```

object  values Array of string   string    

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='702c9648-b18b-41f0-897b-8b8b36cf7ced'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='3c8efeb3-2a46-44a2-8143-523967b9d12c'>Success</option>
</select>Success

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

object  successboolean    

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='96efe99f-4357-4fc1-af78-46d4ba538141'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='5da4fcac-d102-4727-8c49-2d9f89999fb0'>ABAC not enabled</option>
<option value='d23cb614-1425-41f5-b832-0d778c616f9b'>Attribute definition missing</option>
<option value='d6bf81b0-a498-4876-8d38-1d5f79b6f185'>Invalid attribute values</option>
<option value='2b287401-b934-4c9a-b95f-7d1d4f0c60bd'>Duplicate key on a room</option>
<option value='526e3d01-67b2-4d2c-8f0f-164505c8050a'>Cannot convert default room to ABAC</option>
<option value='288fb4ca-076d-44b5-9c54-77ac86adb58b'>Room not found</option>
</select>ABAC not enabled

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

Attribute definition missing

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

Invalid attribute values

```json
{
  "success": false,
  "error": "error-invalid-attribute-values"
}
```

Duplicate key on a room

```json
{
  "success": false,
  "error": "error-duplicate-attribute-key"
}
```

Cannot convert default room to ABAC

```json
{
  "success": false,
  "error": "error-cannot-convert-default-room-to-abac"
}
```

Room not found

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

object  successboolean    
errorstring    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='7602e429-6d5f-48ab-b94d-8cc74586eccd'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='48cb7d1e-9628-4205-af93-b49783af96c2'>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='5aea65ac-d2a2-4df2-8df8-01001bcb46bc'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='4f91da97-94b4-40a1-a4f1-35403dc64a1d'>Missing required ABAC permissions</option>
</select>Missing required ABAC permissions

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

object  successboolean    
errorstring