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

# Workspaces

> Project containers that hold audits, schedules, and findings for a target

# Workspaces

A **Workspace** is a project container scoped to a single target domain. Every audit, scheduled scan, finding, and custom domain configuration belongs to a workspace. For MSSPs and consultancies running multiple engagements, workspaces provide hard isolation per client.

## What a workspace contains

* **Target domain** — the apex domain this workspace audits
* **Audit history** — every engagement run against the target
* **Findings** — aggregated across all audits in the workspace
* **Scheduled audits** — cron-based recurring engagements
* **Custom domain** — optional branded subdomain for report URLs
* **Slack channel** — optional channel for engagement notifications
* **Usage** — compute, AI tokens, and storage scoped to this workspace

## Creating a workspace

1. From the sidebar, click **Workspaces → New Workspace**
2. Enter a display name (e.g., "Acme Production")
3. Enter the target domain (e.g., `acme.example.com`)
4. Click **Create**

Or via API:

```bash theme={null}
curl -X POST https://api.withgiga.ai/api/workspaces \
  -H "Authorization: Bearer $GIGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme Production","domain":"acme.example.com"}'
```

The workspace is ready immediately. Launch your first [audit](/audits/overview).

## Workspace overview

Each workspace page shows:

* **Score trend** — average grade across audits over time
* **Recent audits** — last 10 engagements with status and score
* **Open findings** — outstanding findings across all completed audits
* **Active schedules** — cron-based recurring scans
* **Custom domain** — where reports are published

## Multi-tenant use

For MSSPs running multiple clients:

* **One workspace per client** — keeps audit history, findings, and billing isolated
* **Per-workspace custom domains** — `audits.client-a.com`, `audits.client-b.com`
* **Per-workspace Slack channels** — route notifications to the right team
* **Per-workspace API keys** — issue scoped credentials for client-facing tooling

## Switching workspaces

Use the **workspace switcher** at the top of the left sidebar. Findings, audits, and settings are fully isolated per workspace — you'll only see data for the active workspace.

## Workspace limits

The number of workspaces you can create depends on your plan:

| Plan        | Workspaces |
| ----------- | ---------- |
| Free        | 1          |
| Starter Pro | 10         |
| Max         | Unlimited  |

See [Plans](/billing/plans) for details.

## Deleting a workspace

Deleting a workspace permanently removes all audits, findings, scheduled scans, PDFs, and recordings within it. Active audits are terminated immediately.

1. Open **Workspace Settings** (gear icon)
2. Scroll to **Danger Zone**
3. Click **Delete Workspace** and confirm

<Warning>
  This cannot be undone. If you need an exit copy of the audit history, export the PDFs and recordings first.
</Warning>

## Next steps

<Columns cols={2}>
  <Card title="Audits" icon="shield-check" href="/audits/overview">
    Run your first engagement.
  </Card>

  <Card title="Scheduling" icon="calendar" href="/scheduling">
    Set up recurring audits.
  </Card>

  <Card title="Custom Domains" icon="globe" href="/custom-domains">
    Publish reports under your own domain.
  </Card>

  <Card title="Workspaces API" icon="code" href="/api-reference/workspaces">
    Manage workspaces programmatically.
  </Card>
</Columns>