users#
Browse users resource actions that can be discovered, described, and executed through the Brandwave MCP server.
Capability flow
discover-brandwave-capabilities, describe-brandwave-action, and execute-brandwave-action to work with these actions.list-users#
List users in an organization with pagination and name search.
Example prompt#
List all users in my organization.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| pageIndex | integer | Required | Zero-based page index for pagination. |
| pageSize | integer | Required | Number of items per page (1-100). |
| organizationId | string (UUID) | Required | Organization identifier. |
| searchTerm | string | — | Free-text search term to filter results (max 200 characters). |
| sortBy | string | — | Column name to sort by. |
| sortDirection | 'asc' | 'desc' | — | Sort direction: ascending or descending. |
Response#
Returns { items, totalCount, facets } with paginated results.
Underlying SDK method: bw.users.list(params)
create-user#
Create a new user record during sign-up.
Example prompt#
Create a new user.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| userId | string (UUID) | Required | User identifier (from auth provider). |
string | Required | User email address. | |
| name | string | null | — | User display name (max 255 characters). |
| jobRole | string | null | — | User job role (max 100 characters). |
Response#
Returns { data } with the result.
Underlying SDK method: bw.users.create(params)
get-user#
Retrieve a single user by ID.
Example prompt#
Show me the details for this user.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | User identifier. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.users({ id })
update-user#
Update a user's profile information. Updatable fields: name (display name), email, jobRole (e.g. 'Head of Marketing'), avatarKey (storage key, null to remove). Only include the fields you want to change.
Example prompt#
Update the user.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| userId | string (UUID) | Required | User identifier to update. |
| name | string | — | Updated display name (1-255 characters). |
string | — | Updated email address. | |
| jobRole | string | null | — | Updated job role (max 100 characters). |
| avatarKey | string | null | — | Storage key for the user avatar image. Set to null to remove. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.users.update(params)
request-avatar-upload#
Request a presigned URL for uploading a user avatar image. The client uploads the file directly using the returned URL, then calls PATCH /users/:id with the avatarKey.
Example prompt#
Request avatar upload.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| userId | string (UUID) | Required | User identifier requesting an avatar upload URL. |
| contentLength | integer | Required | Size of the file in bytes. |
| contentType | 'image/jpeg' | 'image/png' | 'image/webp' | 'image/gif' | Required | MIME type of the file. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.users.requestAvatarUpload(params)
change-email#
Request a change to the user's email address.
Example prompt#
Change email.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| userId | string (UUID) | Required | User identifier requesting the email change. |
| newEmail | string | Required | The new email address to change to. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.users.changeEmail(params)
request-user-deletion#
Request an account deletion confirmation email after verifying ownership safeguards.
Example prompt#
Request user deletion.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | User identifier requesting account deletion. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.users.requestDeletion(params)
confirm-user-deletion#
Validate an account deletion token and re-check ownership safeguards before final deletion.
Example prompt#
Confirm user deletion.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | User identifier confirming account deletion. |
| token | string (UUID) | Required | Deletion confirmation token from the email link. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.users.confirmDeletion(params)
delete-user#
Delete a user account using an optional email confirmation token, revoke access, remove memberships, and clear saved profile details.
Example prompt#
Delete this user.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | User identifier to delete. |
| token | string (UUID) | — | Optional deletion confirmation token from the email link. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.users.delete(params)
get-user-settings#
Retrieve a user's personal settings.
Example prompt#
Show me the details for this user settings.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| userId | string (UUID) | Required | User identifier to fetch settings for. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.users.settings(params)
update-user-settings#
Create or update a user's settings, including switching the active organization and managing UI preferences.
Example prompt#
Update the user settings.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| userId | string (UUID) | Required | User identifier to update settings for. |
| activeOrganizationId | string (UUID) | — | Organization to set as the active workspace. |
| preferences | object | — | User UI preferences (shallow-merged into existing). |
Response#
Returns { data } with the result.
Underlying SDK method: bw.users.settings.update(params)