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

# Managing Workspaces

> A comprehensive guide to managing workspaces in Hyperleap AI

Workspaces are collaborative environments where teams can work together on Prompts, Personas, Chatbots, Tools, and Assistants. They provide a structured way to organize your work, manage permissions, and maintain consistency across your organization's AI implementations.

## How Workspaces Work

Workspaces provide a collaborative environment for your organization to work efficiently with AI resources. Here's what makes them powerful:

<CardGroup cols={2}>
  <Card title="Organization & Collaboration" icon="users-rectangle">
    Teams can share and collaborate on Prompts, Personas, Chatbots, Tools, and Assistants efficiently. Experts create reusable resources that the entire team can utilize while maintaining centralized control.
  </Card>

  <Card title="Access Control" icon="shield-check">
    Fine-grained permission management lets you control who can view, edit, and manage Prompts, Personas, Chatbots, Tools, and Assistants. Set role-based access for different team members.
  </Card>

  <Card title="Resource Management" icon="share-nodes">
    Create and share a library of Prompts, Personas, Chatbots, Tools, and Assistants across your organization. Maintain version control and ensure consistency across teams.
  </Card>

  <Card title="Usage Analytics" icon="chart-mixed">
    Track and monitor resource utilization, user activity, and performance metrics. Get insights into how your team uses AI resources.
  </Card>
</CardGroup>

## Prerequisites

To work with Workspaces, you need:

* An account on [Studio](https://studio.hyperleapai.com)
* Admin or Org Owner role for creation

## Creating a Workspace

<Steps>
  <Step title="Create Workspace">
    Navigate to **Workspaces** in the API Console and click **Create New Workspace**

    <Frame>
      <img src="https://mintcdn.com/hyperleap/23G1aHrHluWtzWRC/images/workspaces/create-workspace.png?fit=max&auto=format&n=23G1aHrHluWtzWRC&q=85&s=7e01cee358fed776f4f089c0bcdba3cd" alt="Creating a new workspace" width="800" data-path="images/workspaces/create-workspace.png" />
    </Frame>
  </Step>

  <Step title="Configure Details">
    Configure the details of your workspace:

    <Frame>
      <img src="https://mintcdn.com/hyperleap/23G1aHrHluWtzWRC/images/workspaces/configure-workspace.png?fit=max&auto=format&n=23G1aHrHluWtzWRC&q=85&s=040665efc0536633d11f8afdeddedf61" alt="Configuring workspace settings" width="800" data-path="images/workspaces/configure-workspace.png" />
    </Frame>
  </Step>

  <Step title="Add Team Members">
    Invite and manage your team members:

    <Note>
      You need to be an admin or owner to invite team members.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/hyperleap/23G1aHrHluWtzWRC/images/workspaces/manage-workspace.png?fit=max&auto=format&n=23G1aHrHluWtzWRC&q=85&s=b06b01c3b4a2f300640ce6bda23e71c3" alt="manage workspace" width="800" data-path="images/workspaces/manage-workspace.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/hyperleap/23G1aHrHluWtzWRC/images/workspaces/add-workspace-member.png?fit=max&auto=format&n=23G1aHrHluWtzWRC&q=85&s=b5edf3b0511db6858b9b1f95c3a2c86e" alt="Adding team members" width="800" data-path="images/workspaces/add-workspace-member.png" />
    </Frame>
  </Step>
</Steps>

## Workspace Roles & Permissions

Workspaces use role-based access control to manage what users can do with resources like Prompts, Personas, and Chatbots. Here are the available roles and their permissions:

<AccordionGroup>
  <Accordion title="Owner" icon="crown">
    **Full Control + Transfer Rights**

    * Complete access to all workspace resources
    * Can edit, publish, and delete all content
    * Can transfer resources to other workspaces or organization
    * Can manage workspace settings and members
    * Can assign roles to other users

    **Use Case**: Workspace creator or primary administrator
  </Accordion>

  <Accordion title="Admin" icon="shield-halved">
    **Full Administrative Access**

    * Can edit, publish, and delete resources
    * Can manage workspace members and permissions
    * Cannot transfer resource ownership

    **Use Case**: Co-administrators who need full management capabilities
  </Accordion>

  <Accordion title="Contributor" icon="code">
    **Edit & Collaborate**

    * Can view all workspace resources
    * Can edit content (Prompts, Personas, Chatbots)
    * Can save drafts and publish changes
    * Cannot delete resources or manage permissions

    **Use Case**: Team members actively building and refining AI resources
  </Accordion>

  <Accordion title="Reader" icon="glasses">
    **Read-Only Access**

    * Can view all workspace resources and configurations
    * Can test and preview Chatbots
    * Can view conversation logs and analytics
    * Cannot edit, save, or modify any content

    **Use Case**: Stakeholders who need visibility without editing rights
  </Accordion>

  <Accordion title="Guest" icon="eye">
    **Run-Only Access**

    * Can only test/preview Chatbots
    * Cannot view resource configurations or settings
    * Cannot access detail pages or analytics

    **Use Case**: External testers or limited access scenarios
  </Accordion>
</AccordionGroup>

### Permission Examples

<Tabs>
  <Tab title="Chatbots">
    | Action             | Owner | Admin | Contributor | Reader | Guest |
    | ------------------ | ----- | ----- | ----------- | ------ | ----- |
    | Test Chatbot       | ✓     | ✓     | ✓           | ✓      | ✓     |
    | View Configuration | ✓     | ✓     | ✓           | ✓      | ✗     |
    | Edit Settings      | ✓     | ✓     | ✓           | ✗      | ✗     |
    | Save Draft         | ✓     | ✓     | ✓           | ✗      | ✗     |
    | Publish            | ✓     | ✓     | ✓           | ✗      | ✗     |
    | Delete             | ✓     | ✓     | ✗           | ✗      | ✗     |
    | Transfer           | ✓     | ✗     | ✗           | ✗      | ✗     |
  </Tab>

  <Tab title="Prompts">
    | Action             | Owner | Admin | Contributor | Reader | Guest |
    | ------------------ | ----- | ----- | ----------- | ------ | ----- |
    | Run Prompt         | ✓     | ✓     | ✓           | ✓      | ✓     |
    | View Details       | ✓     | ✓     | ✓           | ✓      | ✗     |
    | Edit/Add Versions  | ✓     | ✓     | ✓           | ✗      | ✗     |
    | Delete             | ✓     | ✓     | ✗           | ✗      | ✗     |
    | Manage Permissions | ✓     | ✗     | ✗           | ✗      | ✗     |
  </Tab>

  <Tab title="Personas">
    | Action              | Owner | Admin | Contributor | Reader | Guest |
    | ------------------- | ----- | ----- | ----------- | ------ | ----- |
    | Chat with Persona   | ✓     | ✓     | ✓           | ✓      | ✓     |
    | View Configuration  | ✓     | ✓     | ✓           | ✓      | ✗     |
    | Edit Persona        | ✓     | ✓     | ✓           | ✗      | ✗     |
    | Delete              | ✓     | ✓     | ✗           | ✗      | ✗     |
    | Activate/Deactivate | ✓     | ✓     | ✓           | ✗      | ✗     |
  </Tab>

  <Tab title="Tools">
    | Action             | Owner | Admin | Contributor | Reader | Guest |
    | ------------------ | ----- | ----- | ----------- | ------ | ----- |
    | Run Tool           | ✓     | ✓     | ✓           | ✓      | ✓     |
    | View Configuration | ✓     | ✓     | ✓           | ✓      | ✗     |
    | Edit/Update        | ✓     | ✓     | ✓           | ✗      | ✗     |
    | Delete             | ✓     | ✓     | ✗           | ✗      | ✗     |
    | Transfer           | ✓     | ✗     | ✗           | ✗      | ✗     |
  </Tab>

  <Tab title="Assistants">
    | Action              | Owner | Admin | Contributor | Reader | Guest |
    | ------------------- | ----- | ----- | ----------- | ------ | ----- |
    | Chat with Assistant | ✓     | ✓     | ✓           | ✓      | ✓     |
    | View Configuration  | ✓     | ✓     | ✓           | ✓      | ✗     |
    | Edit/Update         | ✓     | ✓     | ✓           | ✗      | ✗     |
    | Delete              | ✓     | ✓     | ✗           | ✗      | ✗     |
    | Transfer            | ✓     | ✗     | ✗           | ✗      | ✗     |
  </Tab>
</Tabs>

<Note>
  **Organization Admins & Owners** automatically have full access to all workspace resources, bypassing workspace-level role restrictions.
</Note>

## Troubleshooting

<Accordion title="Permission Conflicts">
  If you're experiencing permission conflicts:

  * Verify your role and permissions in the Workspace
  * Check if you have the necessary admin rights
  * Contact your Workspace admin if issues persist
</Accordion>

<Accordion title="Resource Limits">
  If you've hit resource limits:

  * Review your current usage in the dashboard
  * Consider upgrading your plan for higher limits
</Accordion>

## Need Help?

* Review our [FAQ](/guides/faq)
* Contact [Support](mailto:support@hyperleap.ai)