Update many roles
Apply one set of changes to every role matching your filter.
The filter must be in the query string. A filter in the body is ignored, and a request with no filter is rejected with 400 so you cannot update the whole table by accident.
Authorizations
Organization-scoped API key. Create one in the BuildingSwell app under Organization settings, API keys.
Query Parameters
Full-text search across the resource's search columns. Append :col1,col2 to limit which columns are searched.
AND/OR filter expression, for example type eq 'phase' and isArchived eq false. Simple equality can also be passed as plain field parameters.
Body
Every field is optional. Only the fields you send are changed.
Role name. At least one character.
1What the role is for.
Legacy flat permission strings. Defaults to empty.
Legacy permission string.
Fine-grained permission statements. This is the form the app writes today.
true for the synthetic role behind an API key. Leave it alone on roles you create.
Response
The updated roles.