Skip to main content
A Space is a workspace for Agents and the files those Agents use. Create Spaces when teams, environments, customers, or file boundaries need to stay separate.

​
What a Space contains

Agents

Every Agent belongs to exactly one Space. Runs are created from Agents, not directly from Spaces.

Agent files

Input files and other files that Agents in the Space reference while they run.

​
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.

List spaces

Find available Spaces.

List agents in a Space

Fetch the Agents that belong to a specific Space.

Run all agents in a Space

Start a Run for every Agent in a Space.