---
title: "Workspace"
description: "Members, roles, domain auto-join, API keys, and the settings map"
canonical_url: "https://hoplite.sh/docs/workspace"
markdown_url: "https://hoplite.sh/docs/workspace.md"
---

# Workspace
URL: /docs/workspace
LLM index: /llms.txt
Description: Members, roles, domain auto-join, API keys, and the settings map
Related: /docs/workspace/billing, /docs/workspace/project-settings, /docs/integrations, /docs/cli

# Workspace

A **workspace** is your team's account: members, billing, integrations, and projects all live in it. You can belong to several workspaces and switch between them from the workspace switcher.

## Members and roles

Invite teammates by email under **Settings → Workspace → Members**. Invitations grant membership on acceptance. Roles govern administrative actions like managing members and billing — for example, creating, editing, or deleting an [MCP server](/docs/agent/mcp) requires a fresh owner or admin check, so a session whose role was revoked is rejected.

### Domain auto-join

Workspace owners and admins can add multiple company email domains when a current verified workspace member has an address on that exact domain. Anyone with a verified matching address can then join automatically without an invite. Public email providers aren't eligible, and you can remove a configured domain at any time from **Settings → Workspace → Members**.

## API keys

Create API keys under **Settings → Workspace → API keys**. These bearer tokens authenticate the [CLI](/docs/cli), scripts, and other [API automation](/docs/api/authentication) — the same keys work everywhere.

## The settings map

Settings live at one place (`/settings`), grouped by scope. The unified **Settings → Integrations** page keeps personal, selected-project, and workspace connections together.

### Integrations

| Scope | What's there |
| --- | --- |
| **Personal** | ChatGPT subscription, phone, and personal Slack defaults |
| **Project** | Linear and eligible Sentry bindings for the selected project |
| **Workspace** | GitHub App installation and Slack connection |

### Account

| Page | What's there |
| --- | --- |
| **Profile** | Your identity and email |
| **Preferences** | Theme, accessibility, keyboard shortcuts, and supported-device haptic feedback |
| **Agent personalization** | Personal instructions, response verbosity, and code-comment style for runs you start |

Two-factor authentication and passkeys are also available under **Settings → Account**.

On supported mobile devices, **Haptic feedback** defaults on for buttons, tabs, and message actions and is stored on that device. Unsupported devices keep visual press feedback and hide the switch rather than exposing a control that cannot work.

### Workspace

| Page | What's there |
| --- | --- |
| **General** | Workspace name and slug; compatible Anthropic and OpenAI provider keys when BYOK is enabled |
| **Members** | Invites, roles, domain auto-join |
| **API keys** | Bearer tokens for the [CLI](/docs/cli), scripts, and API automation |
| **Billing** | [Credits, top-ups, and usage](/docs/workspace/billing) |

### Project

Project-scoped settings — repository and base branch, scripts, environment variables, sandbox runtime, MCP servers, and agent defaults — are covered in [Project settings](/docs/workspace/project-settings).

## In this section

- **[Project settings](/docs/workspace/project-settings)** — every project-scoped setting, and how repo-file config and Hoplite overrides resolve
- **[Billing](/docs/workspace/billing)** — prepaid credits, top-ups, what's metered, and usage attribution
- **[Security and data handling](/docs/workspace/security)** — how Hoplite isolates credentials, handles your data, and keeps you in control
- **[Troubleshooting](/docs/workspace/troubleshooting)** — answers to common install, import, thread, and sandbox questions

## Sitemap

See the full [sitemap](/docs/sitemap.md) for all pages.
Well-known sitemap: [/docs/.well-known/sitemap.md](/docs/.well-known/sitemap.md).
