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

# Workspaces

> Isolated sandboxes for data changes that don't affect production until you're ready to promote.

A workspace is an isolated environment where you can make data changes — run scrapers, edit SQL models, update extraction schemas — without touching production. Nothing you do inside a workspace affects what users see until you explicitly promote it.

## How workspaces work

Every write operation in Soria requires a `workspace_id`. Read-only operations (queries, listings, inspections) work without one.

When you create a workspace, you get back a `workspace_id` that you pass to all subsequent tool calls. Once you're satisfied with the results, you promote the workspace to push everything to the production schema.

## Workspace types

<CardGroup cols={2}>
  <Card title="Scraper-based" icon="database">
    Created with a `scraper_name`. Soria clones the scraper's existing production data into the workspace so you're working with a full copy. Use this when your changes involve data ingestion, extraction, or schema updates.
  </Card>

  <Card title="SQL-only" icon="code">
    Created without a `scraper_name`. No data is cloned — the workspace exists purely for SQL model work. Use this when you're building or editing bronze, silver, gold, or platinum models.
  </Card>
</CardGroup>

## Workspace lifecycle

Workspaces move through two states:

| State        | Description                                                                                     |
| ------------ | ----------------------------------------------------------------------------------------------- |
| **Active**   | The workspace is open. You can make changes, run pipeline steps, and delete it if needed.       |
| **Promoted** | The workspace has been promoted to production. It is locked — it cannot be deleted or modified. |

## Next steps

<CardGroup cols={2}>
  <Card title="Creating workspaces" icon="plus" href="/workspaces/creating">
    Learn how to create, list, and delete workspaces.
  </Card>

  <Card title="Promoting workspaces" icon="rocket" href="/workspaces/promoting">
    Push your validated changes to production.
  </Card>
</CardGroup>