Users#

See how an AI assistant can help with users in Brandwave, including example prompts and the details it may ask for.

Using your AI assistant

Connect to the Brandwave MCP server, then ask your AI assistant in natural language. It will choose the right Brandwave task and ask for any details it needs.

List users#

List users in an organization with pagination and name search.

Reads dataSafe to repeat

Example prompt#

text

List all users in my organization.

Details to provide#

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.

What you'll get back#

Returns { items, totalCount, facets } with paginated results.

Get user#

Retrieve a single user by ID.

Reads dataSafe to repeat

Example prompt#

text

Show me the details for this user.

Details to provide#

Name	Type	Required	Description
id	`string (UUID)`	Required	User identifier.

What you'll get back#

Returns { data } with the result.

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#

text

Update the user.

Details to provide#

Name	Type	Required	Description
userId	`string (UUID)`	Required	User identifier to update.
name	`string`	—	Updated display name (1-255 characters).
email	`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.

What you'll get back#

Returns { data } with the result.

Get user settings#

Retrieve a user's personal settings.

Reads dataSafe to repeat

Example prompt#

text

Show my personal settings.

Details to provide#

Name	Type	Required	Description
userId	`string (UUID)`	Required	User identifier to fetch settings for.

What you'll get back#

Returns { data } with the result.

Update user settings#

Create or update a user's settings, including switching the active organization and managing UI preferences.

Example prompt#

text

Switch my active workspace.

Details to provide#

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).

What you'll get back#

Returns { data } with the result.