personal-access-tokens#

Browse personal access tokens resource actions that can be discovered, described, and executed through the Brandwave MCP server.

Capability flow

Connect to the Brandwave MCP server via OAuth, then use discover-brandwave-capabilities, describe-brandwave-action, and execute-brandwave-action to work with these actions.

create-personal-access-token#

Create a new personal access token. The plaintext token is only returned once.

Example prompt#

text
Create a new personal access token.

Parameters#

NameTypeRequiredDescription
namestringRequiredDisplay name for this token.
expiresAtstring (ISO 8601) | nullWhen this token should expire.

Response#

Returns { data } with the result.

Underlying SDK method: bw.personalAccessTokens.create(params)

Store the token securely

The plaintext token is only returned in the creation response. It cannot be retrieved again. Store it securely.

list-personal-access-tokens#

List all personal access tokens for the authenticated user.

Read-onlyIdempotent

Example prompt#

text
List all personal access tokens in my organization.

Response#

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

Underlying SDK method: bw.personalAccessTokens.list()

revoke-personal-access-token#

Revoke a personal access token, immediately invalidating it.

Destructive

Example prompt#

text
Revoke the personal access token.

Parameters#

NameTypeRequiredDescription
idstring (UUID)RequiredToken identifier to revoke.

Response#

Returns { data } with the result.

Underlying SDK method: bw.personalAccessTokens.revoke(params)

Immediate invalidation

Revoking a token immediately invalidates it. Any integrations using this token will stop working. This action cannot be undone.

rotate-personal-access-token#

Rotate a personal access token by revoking the old one and creating a new one.

Example prompt#

text
Rotate the personal access token.

Parameters#

NameTypeRequiredDescription
idstring (UUID)RequiredToken identifier to rotate (revokes old, creates new).

Response#

Returns { data } with the result.

Underlying SDK method: bw.personalAccessTokens.rotate(params)