POST
/
update_brx_acl
{
  "400": {},
  "401": {},
  "403": {},
  "404": {},
  "500": {},
  "httpResponse": {
    "isError": true,
    "statusMsg": "<string>"
  }
}

This endpoint updates the access control list (ACL) for a BRK. It allows you to change the visibility of a BRK (public or private), control whether it can be cloned, and manage user permissions. Only the owner of a BRK or users with editor permissions can update the ACL.

​
Request

​
brxId
string
required

The ID of the BRK to update ACL for

​
isPublic
boolean

Whether the BRK is public (visible to all users) or private (visible only to specified users)

​
isClone
boolean

Whether the BRK can be cloned by other users

​
emails
array
required

Array of user email addresses and their permission levels

​
Example Request (Make Private)

{
  "brxId": "brk-12345678-90ab-cdef-1234-567890abcdef",
  "isPublic": false,
  "isClone": true,
  "emails": [
    {
      "email": "owner@example.com",
      "permission": 2
    },
    {
      "email": "editor@example.com",
      "permission": 1
    },
    {
      "email": "viewer@example.com",
      "permission": 0
    }
  ]
}

​
Example Request (Make Public)

{
  "brxId": "brk-12345678-90ab-cdef-1234-567890abcdef",
  "isPublic": true,
  "isClone": true,
  "emails": [
    {
      "email": "owner@example.com",
      "permission": 2
    }
  ]
}

​
Response

​
httpResponse
object

​
Example Response

{
  "httpResponse": {
    "isError": false,
    "statusMsg": "Successfully updated BRK ACL"
  }
}

​
Error Codes

​
400
object

Bad Request - The request was malformed or missing required parameters

​
401
object

Unauthorized - Authentication credentials are missing or invalid

​
403
object

Forbidden - The authenticated user does not have permission to update the ACL for the requested BRK

​
404
object

Not Found - The requested BRK does not exist

​
500
object

Internal Server Error - An unexpected error occurred on the server

​
Notes

  • Only the owner of a BRK or users with editor permissions can update the ACL.
  • When making a BRK public (isPublic: true), it will be visible to all users, but only users with explicit permissions can edit or delete it.
  • When making a BRK private (isPublic: false), it will only be visible to users specified in the emails array.
  • The isClone parameter controls whether other users can clone the BRK. Cloning creates a copy of the BRK that the user owns and can modify.
  • The emails array must include at least one user with owner permissions (permission level 2).
  • Permission levels:
    • 0: Viewer (can view and execute the BRK)
    • 1: Editor (can view, execute, and edit the BRK)
    • 2: Owner (can view, execute, edit, and delete the BRK, as well as manage permissions)
  • To check the current ACL for a BRK, use the Check BRK ACL endpoint.