---
title: "Set room ABAC attribute values"
slug: "set-room-abac-attribute-values"
updated: 2026-09-03T14:50:33Z
published: 2026-09-03T14:50:33Z
canonical: "developer.rocket.chat/set-room-abac-attribute-values"
---

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

# Set room ABAC attribute values

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

- Sets the values of a single ABAC attribute on a room.
- Replaces the existing values for the given attribute key on the specified room with the provided values array (or creates the attribute if it does not yet exist), enforcing the global attribute definition and ABAC validation rules.
- 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='e6523a9e-1c61-434a-bf30-a124a6056712'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='52a8ed70-b9e8-427e-8662-913b0ecf099f'>Example 1</option>
</select>Example 1

```json
{
  "values": [
    "eng",
    "sales",
    "hr"
  ]
}
```

object  values Array of string   string    

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='735f138f-d88f-4ba7-8590-986d7cfd617d'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='0843c97a-0668-44ba-9e0b-b8721278906e'>Success</option>
</select>Success

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

object  successboolean    

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='88b92233-5528-4365-9fde-08d7c7853e6d'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='0c07cdf0-f147-400a-8aa9-8bacb07f3cfd'>Attribute definition missing</option>
<option value='b6c10dbe-f75f-4838-9aed-fea11493d1ef'>Invalid attribute values</option>
<option value='d8e52ada-b50b-456f-a065-e0630c794489'>Room not found</option>
<option value='a5be40a3-8481-4543-b83f-e55041ae1e85'>Cannot convert default room to ABAC</option>
<option value='5ff90280-e7b3-4aa4-ae66-b04a797c52ec'>ABAC not enabled</option>
</select>Attribute definition missing

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

Invalid attribute values

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

Room not found

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

Cannot convert default room to ABAC

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

ABAC not enabled

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

object  successboolean    
errorstring    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='51307bc2-3af3-4569-9e4c-f9d2761c03c5'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='bac3e999-82a1-407c-a2ff-b6ef7ba54f50'>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='75c54a20-2e73-4fc2-a4fd-720557cf822d'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='9d839bcc-fe88-49b0-90a4-679831694b3d'>Missing required ABAC permissions</option>
</select>Missing required ABAC permissions

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

object  successboolean    
errorstring