Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.brainstormer.io/llms.txt

Use this file to discover all available pages before exploring further.

Brainstormer groups all configuration into a single Settings area. Navigate there from the sidebar, and use the tabs across the top to move between sections.

Organization

Update your organization’s name, industry, and publishing policy.

Team

Invite or remove members and change their roles.

Groups

Organize members into named groups to simplify permission management.

Access

Grant or revoke fine-grained permissions on agents, knowledge bases, and other resources.

Developer portal

Create API applications and generate keys for programmatic access.

Your profile

Update your display name, email, and password.

​
Organization profile

Settings → Organization Here you can update the details that identify your organization across Brainstormer.
  • Organization name — the display name shown in the sidebar and the org switcher. Only owners and admins can edit this.
  • Industry — an optional label (e.g. Technology, Healthcare, Education) used for context.
  • Organization ID — a read-only identifier you can use when contacting support or referencing your org in API calls.
  • Require approval before publishing agent changes — when this checkbox is on, any prompt or model change made by a member must be reviewed and approved by an owner or admin before it goes live. This gives you a safety gate for production agents.
Click Save Changes to apply updates. Members (non-admins) can view this page but cannot make edits.

​
Team access

Settings → Team The Team tab lists every member of your organization with their display name, email address, and current role. From here you can:
  • Invite a member — enter an email address, choose a role, and send an invitation. See Team management for the full invite flow.
  • Change a role — owners can use the role dropdown next to any member’s name to change their role instantly.
  • Remove a member — admins and owners can remove any non-owner member using the remove icon on the right. Access is revoked immediately.

​
Groups

Settings → Groups Groups let you bundle members together so you can manage permissions at scale. Instead of granting access resource by resource to each person, you grant access to a group and add people to it. To create a group:
  1. On the Groups tab, enter a name and an optional description in the Create Group card.
  2. Click Create Group.
To manage group members:
  1. Click a group name to expand it.
  2. Use the Add a member buttons to add people from your organization.
  3. Click Remove next to a member’s name to take them out of the group.
Groups can be deleted with the trash icon. Deleting a group removes it and all its associated permissions; members themselves are not removed from the organization.
Only owners and admins can create, modify, or delete groups.

​
Access permissions

Settings → Access The Access tab gives you resource-level control over what groups and individual members can do. This is more granular than roles — you can, for example, grant a specific group read-only access to a single agent without giving them broader permissions. To grant a permission:
  1. Choose whether to assign to a Group or an individual User.
  2. Select the target from the dropdown.
  3. Choose the Resource Type: agent, knowledge base, conversation, or organization.
  4. Optionally enter a specific Resource ID to scope the permission to one item. Leave it blank to apply to all resources of that type.
  5. Check the Actions you want to allow: read, write, delete, manage, or execute.
  6. Click Grant Permission.
The Current Permissions table below shows all active permissions. Click the remove icon on any row to revoke it immediately.
Only owners and admins can view or modify the Access tab.

​
Developer portal

Developer (sidebar) The Developer portal is where you create API applications and generate the keys needed to call Brainstormer from your own code. Applications are logical containers for your integrations. There are three types:
  • Agent Consumer — apps that call agents to serve end users
  • Web Integration — widgets or scripts embedded in websites
  • Backend Service — server-to-server integrations
Each application holds one or more API keys. Keys are scoped to the application they belong to and cannot be transferred. To create an application and generate a key:
  1. Click New App, fill in a name and optional description, and choose the application type.
  2. Click the application to select it.
  3. Enter an optional key name (e.g. Production, Development) and click Generate Key.
  4. Copy the key immediately — it is shown only once.
Store generated API keys securely. Brainstormer does not display the full key after you navigate away. If a key is lost or compromised, revoke it and generate a new one.

​
Your profile

Your personal profile settings — display name, email address, and password — are separate from your organization settings. Look for your profile controls in the account menu (typically accessible from your avatar or name in the sidebar or top navigation). Profile changes affect only your account and are independent of the organization you are currently viewing.