> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bothive.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Organisation Workspaces

> Set up a shared Bothive workspace for a company, team, or hackathon project.

Organisation workspaces give a group one place to manage people, teams, shared bots, and deployment controls.

## Start with an organisation

Create an organisation from the dashboard, then use its details page as the operating surface for the project. The overview shows members, teams, shared bots, governance posture, recent activity, and pending bot changes.

<Steps>
  <Step title="Create the organisation">Give the organisation a name and a short description that explains what the group is shipping.</Step>
  <Step title="Invite collaborators">Add members by email and assign a default role. Owners and admins can change roles and permissions later.</Step>
  <Step title="Create focused teams">Use teams for product squads, hackathon tracks, or separate bot ownership groups inside the organisation.</Step>
  <Step title="Set deployment policy">Choose whether members can change shared bots and whether production deployments require admin approval.</Step>
</Steps>

## Roles and permissions

Keep production access narrow while allowing contributors to move quickly in preview environments.

| Permission                | Owner/Admin | Member                | Viewer |
| ------------------------- | ----------- | --------------------- | ------ |
| Invite and remove members | Yes         | Optional              | No     |
| Change shared bots        | Yes         | Policy-controlled     | No     |
| Manage schedules          | Yes         | Permission-controlled | No     |
| Deploy production         | Yes         | Permission-controlled | No     |
| Review audit events       | Yes         | Yes                   | Yes    |

## Ship safely

Use staged bot changes for collaboration. Review the diff, test the bot, and promote a version through preview, staging, and production. Production readiness checks and deployment audit events provide a clear trail for enterprise teams without slowing down a hackathon.