API keys#
See how an AI assistant can help with API keys 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.
Create API key#
Create a new API key that can expire. The secret is only returned once.
Example prompt#
text
Create a new API key.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | Required | Display name for this token. |
| expiresAt | string (ISO 8601) | null | — | When this token should expire. |
What you'll get back#
Returns { data } with the result.
Store the key securely
The API key secret is only returned in the creation response. It cannot be retrieved again. Store it securely.
List API keys#
List API keys for the authenticated user.
Reads dataSafe to repeat
Example prompt#
text
List all API keys in my organization.What you'll get back#
Returns { items, totalCount, facets } with paginated results.
Revoke API key#
Revoke an API key, immediately invalidating it.
Changes data
Example prompt#
text
Revoke the API key.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | Token identifier to revoke. |
What you'll get back#
Returns { data } with the result.
Immediate invalidation
Revoking an API key immediately invalidates it. Any integrations using this key will stop working. This action cannot be undone.