---
title: "Create ABAC attribute definition"
slug: "create-abac-attribute-definition"
status: "update"
updated: 2026-09-15T13:59:07Z
published: 2026-09-15T13:59:07Z
canonical: "developer.rocket.chat/create-abac-attribute-definition"
---

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

# Create ABAC attribute definition

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

- Creates a new ABAC attribute definition.
- Registers a global ABAC attribute by specifying its key and the list of allowed values, making it available for use on rooms and users.
- Requires the ABAC license, the `abac-management` and `manage-abac-admin-room-attributes` 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-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

Body parameters<select class='api-response-data' aria-label='Media type'><option value='7ea84332-3b39-4c5c-8ab5-06cc5cf36496'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='5d8337e1-ca30-48c8-b2d1-7fc17f0a9b24'>Example 1</option>
</select>Example 1

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

object  keystring    
values Array of string   string    

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='53839f77-b6ea-4549-9e91-fa6cdd16ca98'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='31f35b6d-02db-4878-bb4f-754ea98a29c8'>Success</option>
</select>Success

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

object  successboolean    

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='ebbfd137-ede3-4b71-8cea-8bf719788097'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='8d286641-73e1-49f6-8581-20f3811c5554'>ABAC disabled</option>
<option value='15eda836-d202-423c-afcc-56bbe6ebba1d'>Invalid attribute values</option>
<option value='b4f783b1-289a-4d87-8a58-c786c203deef'>Invalid attribute key</option>
<option value='c10c3b04-cb48-426c-8cfc-76994705c98d'>Duplicate attribute key</option>
</select>ABAC disabled

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

Invalid attribute values

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

Invalid attribute key

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

Duplicate attribute key

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

object  successboolean    
errorstring    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='42080f0c-4831-4bf3-a3e8-02073ff15b06'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='192e4059-d974-4000-baaf-28302f41281e'>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='25d8ce49-98f5-475e-88ed-ed2410e2a167'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='572760db-41a6-495e-9ad4-ac16776fa64b'>Missing required ABAC permissions</option>
</select>Missing required ABAC permissions

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

object  successboolean    
errorstring