---
title: "Assign a role to a list of users"
method: POST
path: "/roles/assign"
tags: ["roles"]
---

# Assign a role to a list of users

`POST /roles/assign`

This is a business/enterprise only endpoint

## Request body

- RolesAssign
  - `appBuilder` object — Allow setting users to builders per app.
    - `appId` string, required — The app that the users should have app builder privileges granted for.
  - `builder` boolean — Add/remove global builder permissions from the list of users.
  - `admin` boolean — Add/remove global admin permissions from the list of users.
  - `role` object — Add/remove a per-app role, such as BASIC, ADMIN etc.
    - `roleId` string, required — The role ID, such as BASIC, ADMIN or a custom role ID.
    - `appId` string, required — The app that the role relates to.
  - `userIds` string[], required — The user IDs to be updated to add/remove the specified roles.

## Response `200`

Returns a list of updated user IDs

- RolesOutput
  - `data` object, required
    - `userIds` string[], required — The updated users' IDs

---

[API](https://skmtc.net/budibase/apis/budibase-api.md) · [All operations](https://skmtc.net/budibase/apis/budibase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/budibase/budibase-api/revisions/9c6f16fc652b/schema)