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

# Spaces

> Workspaces for Agents and the files those Agents use.

A **Space** is a workspace for [Agents](/concepts/agents) and the files those Agents use.

Create Spaces when teams, environments, customers, or file boundaries need to stay separate.

## What a Space contains

<CardGroup cols={2}>
  <Card title="Agents" icon="robot" href="/concepts/agents">
    Every Agent belongs to exactly one Space. Runs are created from Agents, not directly from Spaces.
  </Card>

  <Card title="Agent files" icon="folder-open">
    Input files and other files that Agents in the Space reference while they run.
  </Card>
</CardGroup>

## When to create another Space

Create a new Space when you need a clear boundary:

* **Agent groups** — Marketing, Pricing, Compliance, and Risk can each keep their Agents together.
* **Environments** — separate `production` and `staging` so agent changes can be tested before they affect live workflows.
* **Customers** — resellers and service teams can give each customer their own Space.
* **Files** — separate Spaces when Agents should not share the same file workspace.

If the same Agents use the same file workspace, keep them in one Space.

## Related API references

<CardGroup cols={2}>
  <Card title="List spaces" icon="layer-group" href="/api-reference/spaces/list">
    Find available Spaces.
  </Card>

  <Card title="List agents in a Space" icon="robot" href="/api-reference/spaces/agents">
    Fetch the Agents that belong to a specific Space.
  </Card>

  <Card title="Run all agents in a Space" icon="play" href="/api-reference/spaces/run-all">
    Start a Run for every Agent in a Space.
  </Card>
</CardGroup>