> ## Documentation Index
> Fetch the complete documentation index at: https://vlyai-1c28d863.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspaces

> The top-level container for projects, members, and billing. A user can belong to many workspaces.

A **workspace** is the unit of ownership in vly. Projects belong to a workspace; members belong to a workspace; billing is per-workspace. Most users start with a single workspace tied to their account; teams typically create one per company.

## What lives in a workspace

<CardGroup cols={2}>
  <Card title="Projects" icon="folder">
    Every vly app belongs to one workspace.
  </Card>

  <Card title="Members" icon="users">
    People with access. Roles are workspace-wide.
  </Card>

  <Card title="Billing" icon="credit-card">
    One subscription, one card on file.
  </Card>

  <Card title="Integrations" icon="puzzle">
    Connected services (GitHub, Stripe, Resend) are scoped to the workspace.
  </Card>

  <Card title="API keys" icon="key">
    Keys authorize against one workspace.
  </Card>

  <Card title="Audit log" icon="scroll-text">
    All meaningful actions in the workspace.
  </Card>
</CardGroup>

## Creating a workspace

<Steps>
  <Step title="Settings → Workspaces → Create new">
    Pick a name and slug. Slug becomes part of URLs.
  </Step>

  <Step title="You become the owner">
    First member; sole owner.
  </Step>

  <Step title="Invite members">
    Settings → Members. Email or invite link. Set roles.
  </Step>
</Steps>

## Switching workspaces

The workspace switcher lives at the top-left of the dashboard. Click to switch between workspaces you belong to.

## Transferring ownership

To hand off a workspace:

1. Settings → Members → \[target user] → "Transfer ownership".
2. Confirm. The target user becomes owner; the previous owner becomes admin.

Cannot be undone without the new owner cooperating.

## Deleting a workspace

Settings → Workspaces → Delete. Two-step confirmation. **Permanently deletes** all projects, data, and members. Members keep their personal accounts.

## Related

<CardGroup cols={3}>
  <Card title="Teams" icon="users" href="/features/workspace/teams">
    Sub-groupings within a workspace.
  </Card>

  <Card title="Roles" icon="user-cog" href="/features/workspace/roles">
    Permission tiers.
  </Card>

  <Card title="Multi-tenancy patterns" icon="layers" href="/architecture/multi-tenancy">
    Architectural patterns for apps that need their own workspaces.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.