organizations#
Browse organizations 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-organizations#
List organizations the current user belongs to, with membership details.
Example prompt#
List all organizations 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). |
| userId | string (UUID) | Required | User identifier to list organizations for. |
Response#
Returns { items, totalCount, facets } with paginated results.
Underlying SDK method: bw.organizations.list(params)
get-organization#
Retrieve a single organization by ID.
Example prompt#
Show me the details for this organization.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | Organization identifier. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.organizations.get({ id })
create-organization#
Create an organization with a name, timezone, and currency, then assign the requesting user as owner.
Example prompt#
Create a new organization.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| userId | string (UUID) | Required | User identifier of the organization owner. |
| name | string | Required | Organization name. |
| ianaTimezone | 'UTC' | 'America/New_York' | 'America/Chicago' | 'America/Denver' | 'America/Los_Angeles' | 'America/Anchorage' | 'Pacific/Honolulu' | 'America/Toronto' | 'America/Vancouver' | 'Europe/London' | 'Europe/Paris' | 'Europe/Berlin' | 'Australia/Sydney' | 'Australia/Melbourne' | 'Pacific/Auckland' | 'Asia/Tokyo' | 'Asia/Singapore' | null | — | IANA timezone identifier. |
| currency | 'USD' | 'CAD' | 'GBP' | 'EUR' | 'AUD' | 'NZD' | 'JPY' | 'SGD' | — | ISO 4217 currency code. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.organizations.create(params)
complete-organic-signup#
Create a first-time organic signup workspace using the submitted organization name, timezone, and currency, then join the default demo org as a viewer and switch the active organization to the demo workspace.
Example prompt#
Complete organic signup for my organization.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| userId | string (UUID) | Required | User identifier completing first-time organic onboarding. |
| name | string | Required | Name of the real organization to create for the user. |
| ianaTimezone | 'UTC' | 'America/New_York' | 'America/Chicago' | 'America/Denver' | 'America/Los_Angeles' | 'America/Anchorage' | 'Pacific/Honolulu' | 'America/Toronto' | 'America/Vancouver' | 'Europe/London' | 'Europe/Paris' | 'Europe/Berlin' | 'Australia/Sydney' | 'Australia/Melbourne' | 'Pacific/Auckland' | 'Asia/Tokyo' | 'Asia/Singapore' | null | — | IANA timezone identifier. |
| currency | 'USD' | 'CAD' | 'GBP' | 'EUR' | 'AUD' | 'NZD' | 'JPY' | 'SGD' | — | ISO 4217 currency code. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.organizations.completeOrganicSignup(params)
update-organization#
Update an organization's name, description, timezone, currency, conversion value for ROI calculations, or attribution window.
Example prompt#
Update the organization.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | Organization identifier to update. |
| name | string | — | Updated organization name (1-255 characters). |
| ianaTimezone | 'UTC' | 'America/New_York' | 'America/Chicago' | 'America/Denver' | 'America/Los_Angeles' | 'America/Anchorage' | 'Pacific/Honolulu' | 'America/Toronto' | 'America/Vancouver' | 'Europe/London' | 'Europe/Paris' | 'Europe/Berlin' | 'Australia/Sydney' | 'Australia/Melbourne' | 'Pacific/Auckland' | 'Asia/Tokyo' | 'Asia/Singapore' | null | — | Updated IANA timezone. |
| currency | 'USD' | 'CAD' | 'GBP' | 'EUR' | 'AUD' | 'NZD' | 'JPY' | 'SGD' | — | Updated currency code. |
| conversionValue | number | — | Average customer value for ROI calculations (non-negative). |
| defaultAttributionWindowDays | integer | null | — | Number of days for the attribution window (must be greater than zero). |
Response#
Returns { data } with the result.
Underlying SDK method: bw.organizations.update(params)
delete-organization#
Permanently delete an organization and all associated data.
Example prompt#
Delete this organization.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | Organization identifier to delete. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.organizations.delete(params)
Destructive action
list-organization-users#
List users in an organization with pagination and search.
Example prompt#
List all organization 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.organizations.users.list(params)
add-organization-user#
Add an existing user to an organization with a specified role.
Example prompt#
Add the organization user.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| organizationId | string (UUID) | Required | Organization identifier. |
| userId | string (UUID) | Required | User identifier to add. |
| role | 'owner' | 'member' | 'viewer' | Required | Role to assign (owner, member, or viewer). |
Response#
Returns { data } with the result.
Underlying SDK method: bw.organizations.users.add(params)
update-organization-user-role#
Update a user's role within an organization.
Example prompt#
Update the organization user role.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| organizationId | string (UUID) | Required | Organization identifier. |
| userId | string (UUID) | Required | User identifier whose role is being changed. |
| role | 'owner' | 'member' | 'viewer' | Required | New role to assign (owner, member, or viewer). |
Response#
Returns { data } with the result.
Underlying SDK method: bw.organizations.users.updateRole(params)
remove-organization-user#
Remove a user's membership from an organization.
Example prompt#
Remove the organization user.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| organizationId | string (UUID) | Required | Organization identifier. |
| userId | string (UUID) | Required | User identifier to remove. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.organizations.users.remove(params)
invite-organization-user#
Invite a user to an organization by email.
Example prompt#
Invite a user to my organization.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
string | Required | Email address to send the invite to. | |
| organizationId | string (UUID) | Required | Organization identifier. |
| role | 'owner' | 'member' | 'viewer' | Required | Role to assign to the invited user (owner, member, or viewer). |
Response#
Returns { data } with the result.
Underlying SDK method: bw.organizations.users.invite(params)
Authorization required
accept-organization-invite#
Accept a pending organization invite.
Example prompt#
Accept organization invite for my account.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| organizationId | string (UUID) | Required | Organization identifier. |
| userId | string (UUID) | Required | User identifier accepting the invite. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.organizations.users.acceptInvite(params)
decline-organization-invite#
Decline a pending organization invite.
Example prompt#
Decline organization invite for my account.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| organizationId | string (UUID) | Required | Organization identifier. |
| userId | string (UUID) | Required | User identifier declining the invite. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.organizations.users.declineInvite(params)
process-invite-signup#
Process invite metadata for a newly signed-up user.
Example prompt#
Process invite signup.Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| userId | string (UUID) | Required | Authenticated user whose invite metadata should be processed. |
Response#
Returns { data } with the result.
Underlying SDK method: bw.organizations.users.processInviteSignup()