Post
/api/v1/abac/rooms/:rid/attributes
- Replaces the full ABAC attribute set for a room.
- Sets the complete set of ABAC attributes on the specified room by providing an attributes object that maps attribute keys to arrays of allowed values; any previously assigned attributes not included in the request are removed.
- Requires the ABAC license, the
abac-managementandmanage-abac-admin-roomspermissions, and the global settingABAC_Enabledto be turned on.
Changelog
| Version | Description |
|---|---|
| 8.0.0 | Added |
| 8.5.0 | Added the manage-abac-admin-rooms granular permission requirement. |
Header parameters
X-Auth-Token
stringRequired
The authToken of the authenticated user.
ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-Id
stringRequired
The userId of the authenticated user.
ExamplerbAXPnMktTFbNpwtJ
Body parameters
Example 1
{
"attributes": {
"department": [
"it",
"sales"
],
"region": [
"asia",
"europa"
]
}
}object
Responses
200
OK
Success
{
"success": true
}object
success
boolean
400
Bad Request
ABAC not enabled
{
"success": false,
"error": "error-abac-not-enabled"
}Attribute definition missing
{
"success": false,
"error": "error-attribute-definition-not-found"
}Invalid attribute values
{
"success": false,
"error": "error-invalid-attribute-values"
}object
success
boolean
error
string
401
Unauthorized
Authorization Error
{
"status": "error",
"message": "You must be logged in to do this."
}object
status
string
message
string
403
Forbidden
Missing required ABAC permissions
{
"success": false,
"error": "error-not-authorized"
}object
success
boolean
error
string