Skip to content

Glossary

The words these docs use, and what each one means.

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

Type to search…

↑↓ navigate↵ selectEsc close