Skip to main content

Organizations

An organization is a workspace that groups together:

  • Projects: All your team's notebooks, live apps, pipelines, and files
  • Users: Team members with specific roles and permissions
  • Subscription: Shared resources (CPU/GPU hours, storage) and billing

Organizations are ideal for:

  • Companies managing multiple client projects
  • Teams collaborating across different departments
  • Managing billing and resources in one place

Users can belong to multiple organizations and switch between them as needed.

info

Every member can open the organization page and browse its tabs. Changing organization settings requires the Administrator role; the Integrations tab and the administrator-only AI sub-tabs (Limits, Compaction, MCP servers, Skills) are shown only to administrators.

When you have no active project in an organization (for example, an administrator who is not a viewer of any project), MINEO opens the organization page directly and the sidebar lists its tabs.

General​

The General tab contains two sub-sections for managing your organization:

General Information​

Configure the basic details of your organization:

  • Name: The display name for your organization. This is visible to all members and appears throughout the platform.
  • Description: A brief explanation of your organization's purpose or scope. Helps team members understand the organization's context.
  • Avatar/Logo: Upload an image to visually identify your organization (optional).

These details help personalize your workspace and make it easier for team members to identify and understand the organization's purpose.

Custom Domains​

Configure how your organization and Live Apps are accessed publicly. MINEO offers two options:

  • Slug: Quick setup using MINEO's domain (e.g., b.mineo.app/your-slug/live_app/app-name)

    • Perfect for internal team use and getting started
    • Free and easy to configure

  • Custom Domain (Pro plans): Use your own domain (e.g., apps.yourcompany.com/live_app/app-name)

    • Professional branding for client-facing applications
    • Requires DNS configuration
    • Available on select paid plans
tip

For detailed information about configuring slugs and custom domains, including DNS setup, see Slug and Custom Domains.

AI​

The AI tab groups the AI settings shared across the organization in sub-tabs: General, Limits, Models, Compaction, MCP servers, and Skills. General and Models are visible to every member; the rest are shown only to administrators.

  • General → Chat disclaimer: A short notice shown permanently below the chat input in threads (including shared threads), for every project in the organization (e.g. "AI can make mistakes. Check important information."). Toggle Show chat disclaimer to enable it, then write the message. It supports Markdown, so you can include links to your usage policy. The disclaimer is disabled by default.

  • General → Web search domain restrictions (administrators only): Control which websites Assistants in this organization can search. Two independent lists are available:

    • Allowed domains — when set, all web searches across every Assistant are restricted to these domains only.
    • Blocked domains — domains excluded from all search results, regardless of the query.

    Enter bare domain names (e.g. wikipedia.org) — no scheme (https://), no path. Leave both lists empty to impose no organization-wide restriction. These settings override per-assistant domain configuration; the assistant form displays the active lists as read-only when an organization-level restriction is in place. See Web search for the per-assistant configuration.

  • Limits (administrators only): USD cost limits per user (daily, weekly, monthly) and for the whole organization (monthly), with per-user, per-group and per-project overrides and an extra usage wallet per user. Warning at 80%, block at 100%. See AI Cost Limits.

  • Models → Credentials (administrators only): Store API provider keys (OpenAI, Anthropic, Google, Azure OpenAI) for serving custom models. Each credential requires a provider, a key name, the API key (encrypted at rest), and optionally a Base URL to override the default endpoint (required for Azure OpenAI; also useful for self-hosted gateways or proxies like LiteLLM). You can test the connection before saving. Credentials are the foundation for BYOK models — you must add a credential before creating a model.

  • Models → Models (administrators only): Create Bring Your Own Key (BYOK) models using your organization's credentials. Each model links a credential to a base model from your plan (e.g. GPT-4o, Claude Sonnet). Pricing, context limits, and capabilities are inherited from the base model and stay in sync automatically. You can set a custom display name, override the model ID sent to the provider, and choose a hosting region (useful for Azure OpenAI regional deployments). Once created, these models are available to all assistants in the organization alongside the plan's global models.

  • Compaction (administrators only): model used to summarize a thread when a user compacts it; platform and BYOK models are available, empty means the thread's own model. See Context window and compaction.

  • Skills (administrators only): Create and manage reusable prompt fragments shared by Assistants in every project in the organization. Administrators can add, edit, clone, categorize, and delete organization skills. Members and viewers can browse them, and users with permission to edit an Assistant can select them, but only organization administrators can change the shared catalog. Global MINEO skills remain read-only. See Assistant skills for loading modes, token usage, and selection behavior.

  • MCP servers (administrators only): Create and manage remote tool servers shared with Assistants in every project in the organization. Open AI → MCP servers to configure the endpoint and authentication, test the connection, and synchronize its tools. The organization catalog contains only organization-scoped servers; project settings show both project servers and inherited organization servers. See MCP servers for scopes, permissions, and tool configuration.

Workspace​

The Workspace tab provides a central overview of resources shared across the organization: worker images, data sources, and Assistants that administrators have promoted to the organization level. Each sub-tab lists the shared resources with their origin project; members and viewers can browse them, and administrators can stop sharing from the ... menu.

Worker images​

Worker images shared at the organization level are available in every project's worker image selector, marked with an Organization badge. Administrators can:

  • Promote: From any project's worker image list (or the image's Permissions tab), share it across all projects
  • Demote: From the organization's Workspace tab (or the image's Permissions tab), stop sharing it. Resources in other projects that used it are unlinked and fall back to their default image; the image's own project is unaffected

See Worker Images for details on creating and managing worker images.

Data sources​

Data sources shared at the organization level are available in every project's Data Sources list and selectors, marked with an Organization badge. Other projects can query them, test the connection, and scan tables; editing, cloning, and deleting stay in the origin project.

  • Promote: From the data source's ... menu in its project, select Visibility → Organization.
  • Demote: From the organization's Workspace → Data Sources tab, open the ... menu and select Visibility → Project (the same menu offers Go to project). MINEO asks for confirmation. The same option is available from the project menu.

See Organization-level data sources for details.

Assistants​

Assistants shared at the organization level are available in every project's Assistants list and thread picker, marked with an Organization badge. Other projects can chat with them; editing, cloning, deleting, and setting as default stay in the origin project.

  • Promote: From the Assistant's ... menu in its project, select Visibility → Organization.
  • Demote: From the organization's Workspace → Assistants tab, open the ... menu and select Visibility → Project (the same menu offers Go to project). MINEO asks for confirmation. The same option is available from the project menu.

See Organization-level Assistants for details.

Integrations​

The Integrations tab (administrators only) holds connections shared by every project in the organization: Slack, Email, SSH keys, Google Drive, and SharePoint/OneDrive. They appear in each project's Settings → Integrations with an Organization badge, in Assistant connection selectors, and in notification rules, grouped under Organization. Only organization administrators edit or delete them; project administrators who also administer the organization can move an integration between the project and organization scopes from the project's integration form.

One SSH key is allowed per organization. Git operations use the project's own key and fall back to the organization's key when the project has none.

Use Projects → Default permissions (or Configure for a single project) to allow or restrict Create integrations for project administrators. Existing project integrations keep working when creation is restricted.

Members​

The Members tab helps you manage user access to your organization. It contains two sub-sections:

Members​

Add and manage users who have access to your organization. Each user has two independent role dimensions:

Content Access Role (what they can do with project resources):

  • Viewer: Can only view resources like notebooks and files (read-only access)
  • Editor: Can edit notebooks and files based on project permissions

Organization Role (their organization permissions):

  • Member: Can access the organization but cannot change organization settings
  • Administrator: Has full control over organization settings, user management, and billing
info

These roles are independent. For example, a user can be an "Editor + Member" (can edit content but not manage the organization) or a "Viewer + Administrator" (read-only on projects but can manage organization settings).

The Online column shows which members currently have MINEO open in their browser (green dot). It reflects an open browser tab, not a running worker or notebook, and refreshes when you reload the page. Sort by the column to bring online members to the top.

You can add users in two ways:

  • Add Existing Users: Bring existing MINEO users into your organization
  • Invite New Users: Send email invitations to users not yet on MINEO
caution

Your plan sets limits on viewers and editors. To add more users, you may need to upgrade your plan.

Invitations​

Manage pending email invitations sent to users who haven't joined MINEO yet. In this tab you can:

  • View all pending invitations
  • Resend invitations if needed
  • Cancel invitations before they are accepted
  • Assign roles and permissions to invited users before they even log in
tip

Invited users are pre-created in MINEO, allowing administrators to configure their access and permissions in advance.

Groups​

Groups allow you to manage multiple users as a single unit, making it easier to assign roles and permissions at scale.

What are Groups?​

A group is a collection of users that share the same organization role. Instead of configuring each user individually, you can:

  • Create a group with specific permissions
  • Add multiple users to that group
  • All group members automatically inherit the group's organization role

How Groups Work​

Organization Role Inheritance

  • Each group has an organization role (Member or Administrator)
  • Users in the group inherit this role for organization-level permissions
  • Individual content access roles (Viewer/Editor) remain unchanged

Multiple Group Membership

  • Users can belong to multiple groups simultaneously
  • When a user belongs to multiple groups with different roles, the least restrictive role applies
  • Example: If a user is in "Developers" (Member) and "Team Leads" (Administrator), they will have Administrator permissions

Common Use Cases​

  • Department-based access: Create groups like "Engineering", "Sales", "Support" with appropriate permissions
  • Client segregation: Separate groups for different client teams with limited access
  • Project teams: Temporary groups for specific projects that can be easily dissolved
  • Role-based management: "Administrators", "Managers", "Contributors" with different permission levels

Projects​

The Projects tab allows administrators to view and manage all projects belonging to the organization.

What are Projects?​

Projects are workspaces where your team creates and manages computational resources like:

  • Notebooks: Interactive Jupyter notebooks for data analysis and development
  • Live Apps: Published applications (Streamlit, Gradio, etc.) accessible to users
  • Pipelines: Automated workflows and scheduled tasks
  • Files and Datasets: Shared storage for project resources

Managing Projects​

In this tab you can:

  • View all projects: See all projects associated with your organization
  • Create new projects: Add projects up to your plan's limit
  • Monitor project status: Check which projects are active and their resource usage
  • Access project settings: Navigate directly to individual project configurations
  • Mark favorites: the Favorites column stars a project; the same star button in the toolbar filters the table to favorites only. Favorites are personal, not shared with other members. My profile → Organizations has the same column for organizations.

Configure project permissions​

Organization administrators can control which projects may configure specific project-owned resources:

  1. Open Organization settings → Projects.
  2. Select Default permissions.
  3. Choose Allow or Restrict for each default permission.
  4. Select Save.

The organization default applies to every project that inherits it. Changing the default therefore affects inheriting projects immediately, while explicit project overrides remain unchanged.

For a single project, select Configure in its Permissions column. The same action is also available from the row menu. Both open a project-focused editor with Inherit / Allow / Restrict for each policy; the toolbar action remains available for organization defaults.

Available policies:

  • Create MCP servers: restricting it prevents project administrators from creating project-scoped MCP servers or moving an organization server into the project. Existing project servers remain linked, visible, editable, and usable. Organization-scoped server creation is not affected.
  • Create integrations: restricting it prevents project administrators from creating project-scoped integrations or moving an organization integration into the project. Existing project integrations keep working. See Integrations.
info

Effective access follows three checks: the subscription plan must include MCP, the project must be allowed by the organization policy, and the user must be a project administrator.

caution

The number of available project slots is determined by your purchased subscription. To create more projects, you may need to upgrade your plan.

Project Permissions vs Organization Permissions​

Important: Organization permissions and project permissions are managed separately:

  • Organization permissions (configured in the Members/Groups tabs): Control who can manage the organization itself
  • Project permissions (configured within each project): Control who can access and edit resources within that specific project

This separation provides flexibility to:

  • Give someone organization admin access without access to all projects
  • Grant project-specific access to external collaborators without organization membership
  • Create different permission structures for different projects within the same organization
tip

For detailed information about project configuration and permissions, see the Projects documentation.

Activity​

The Activity tab allows administrators to monitor organizational events and resource usage. It contains three sub-sections:

Stats​

Monitor your organization's resource consumption with detailed metrics on compute and storage usage.

Period selection (CPU/GPU and AI)

  • View by: aggregate consumption by Day, Week or Month. The chart always spans every bucket returned (last 30 days, 26 weeks or 12 months)
  • Detail of: the range the KPI cards and the detail tables summarise (e.g. last 7 days, last 4 weeks, last month)
  • Quotas (CPU/GPU hours per user and month, AI monthly budget) are defined per month, so their percentages and progress bars only appear on a single-month range

CPU/GPU Usage

  • View total CPU and GPU hours consumed in the selected range
  • Compare usage against your plan's available hours
  • See number of active sessions using compute resources
  • Breakdown per user and per project, filterable by Project and User
  • Visual indicators showing usage percentage relative to your quota

Storage Usage

  • Track total storage consumption across the organization
  • Monitor storage usage per project
  • Compare against your plan's storage limit
  • Worker images: registry space taken by the worker images, with a Per worker image detail table (image, project, latest tag, number of tags, space). Only the most recent tag of every image counts towards the space — older tags share most of their layers with it, and the tag count tells you how much history has piled up behind it
  • Identify which users or projects are consuming most storage space

AI Usage

  • View total AI cost (USD) consumed in the selected range
  • Compare cost against your plan's monthly AI budget
  • Track total requests and tool calls made to AI models
  • Breakdown of input and output tokens per bucket
  • Breakdown per user and per project of cost, requests, and token usage
  • Filter by Project, Provider, Model, and User; administrators can jump to limits via Manage limits
note

The Storage section queries the storage backend once per project, so it is only loaded the first time you open its tab. The CPU/GPU and AI sections never wait for it.

Usage​

Track how organization members interact with different project resources:

  • Notebooks: Monitor access and usage patterns for Jupyter notebooks
  • Live Apps: See which published applications (Streamlit, Gradio, etc.) are being accessed
  • Pipelines: View activity on automated workflows and scheduled tasks

This information helps administrators:

  • Monitor team engagement with different resources
  • Identify most-used applications and notebooks
  • Optimize resource allocation based on actual usage patterns
  • Make informed decisions about infrastructure needs

Events​

View a chronological timeline of important organizational activities with powerful filtering and export capabilities.

Event types tracked:

  • User additions and removals
  • Project creation and deletion
  • Permission changes on resources
  • Organization membership updates
  • Configuration updates
  • Worker session terminated
  • Other administrative actions

Filtering options:

  • Event type: Filter by specific event categories
  • Project: Filter events by project
  • User: Filter events by user who performed the action
  • Date range: Select a specific time period with preset options (Today, Last 7 Days, Last 30 Days, etc.)
  • Message search: Search within event messages

Event details: Each event record includes:

  • Date and time of the action
  • Event type with color-coded tags
  • User who performed the action
  • Associated project (if applicable)
  • Resource affected
  • IP address of the request
  • Additional properties and messages

Export: Download the complete event log as an Excel file for external analysis, reporting, or compliance purposes.

This audit trail helps administrators maintain oversight of organizational changes, track who did what and when, and meet compliance requirements.

Plan​

View and manage your organization's subscription plan and billing.

What you'll see:

  • Detailed breakdown of your current plan features (users, storage, computing resources, etc.)
  • Comparison table with available upgrade options
  • Subscription renewal information and billing alerts

What you can do:

  • Upgrade to a higher plan
  • Manage billing through the customer portal (payment methods, billing history)
  • Cancel or modify your subscription
tip

For detailed pricing information, visit the MINEO Pricing page.

Advanced​

The Advanced tab contains critical organization management options.

Delete Organization​

Permanently remove the organization and all its associated data, including:

  • All projects and their resources (notebooks, files, pipelines, live apps)
  • User memberships and groups
  • Configuration and settings
  • Activity history
caution

This action is irreversible. Once deleted, the organization and all its data cannot be recovered. Make sure to back up any important data before proceeding.