Skip to main content
PUT
Update workspace group

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

group_id
string
required

ID of the group to update. Get it from id in List workspace groups.

Query Parameters

workspaceId
string
required

ID of the workspace. With a personal access token, use the token's workspace. Get it from organization_id in Get app.

Minimum string length: 1

Body

application/json
name
string | null

New name, up to 100 characters. An identity-provider group's name can't change.

Required string length: 1 - 100
Example:

"Brand design"

description
string | null

New description, up to 500 characters. An empty string clears it.

Maximum string length: 500
Example:

"Brand and marketing designers"

role
string | null

New role: admin, editor, viewer, or no_access. Send null to clear it so the group grants no role, or leave it out to keep it.

Example:

"viewer"

Response

The updated group.

id
string
required

ID of the group.

Example:

"68b4e1d2c9a7f3001e2d4b61"

name
string
required

Name of the group.

Example:

"Design team"

source
string
required

custom for a group created in Base44, or idp for one your identity provider sends through SCIM. An idp group's name and members come from the identity provider.

Example:

"custom"

member_count
integer
required

Number of members.

Example:

12

description
string | null

Short description of the group, or null when it has none.

Example:

"Product designers"

role
string | null

Role every member gets from the group: admin, editor, viewer, or no_access. null when the group grants no role.

Example:

"editor"

unresolved_count
integer
default:0

Members your identity provider sent who don't have a Base44 account in the workspace yet. Always 0 for a custom group.

Example:

0