Each word has one meaning across the Sutra API, SDKs, CLI and docs. Other platforms, and older Sutra APIs, sometimes use other words for the same thing; those are in the last column.
| Word | Meaning | Also called elsewhere |
|---|---|---|
| Tenant, organization, project | The levels of tenancy. A project is the parent of every resource you create. | |
| Sandbox | An isolated microVM. The one compute primitive: everything you run on Sutra runs in a sandbox. | |
| Process | Anything that runs in a sandbox: a command, a terminal or a piece of code. | exec, command |
| Port | A port of a sandbox that you make reachable, with its address and access. | preview, binding, listener, endpoint |
| Template | A named environment a sandbox can start from. Its versions never change. | image, profile |
| Snapshot | The captured state of a sandbox. New sandboxes can start from it. | |
| Volume | Storage that outlives a sandbox’s disk. | durable volume, storage binding |
| Operation | What a slow call returns to track its work. See Operations. | |
| Agent | A workload addressed by session: each session id gets its own sandbox. | |
| Session | One conversation or task with an agent: an id mapped to a sandbox. Other kinds are always named in full, such as “SSH session”. | |
| Service | A workload that runs all the time and serves requests on a stable host. Sutra’s own parts, such as the model gateway, are platform services. | |
| Revision | A version of an agent’s or a service’s definition. It never changes. | deployment |
| Workload | The word for agents, services, jobs and workers together, and for the identity each one has (“workload identity”). | |
| Instance | A running sandbox that belongs to a workload. | app runtime |
| Namespace | A workflow namespace in the workflow service. | |
| Stop, start | Release a sandbox’s compute, and give it compute again, keeping what it preserves. | pause, resume, archive, hibernate |
| Delete | Remove a resource. To end a running process, send it a signal. | kill, close, destroy, terminate |