Environments & workspaces

Workspaces

A workspace is where apps, sandboxes, volumes, secrets, tokens and billing live. Everyone gets a personal workspace at sign-up and can create more. Switch with the selector at the top of the sidebar.

Members and roles

RoleCan
OwnerEverything, including billing withdrawals, assigning roles and deleting the workspace
ManagerInvite and remove members, set roles below owner, manage spend limits, all compute actions
MemberRun, create sandboxes, manage secrets and volumes

Invite by email from Settings → Members. The invitee accepts the link with an account that uses the invited address.

Environments

Environments partition a workspace: apps, secrets and volumes in staging are separate from main. Create them in Settings → Environments, select one in the sidebar, or set a default for the CLI:

ts env create staging ts env use staging TS_ENVIRONMENT=main ts app list # one-off override

API tokens

Tokens are scoped to a workspace and created in Settings → API tokens. Send them as Authorization: Bearer <token-id>:<token-secret> and pick the environment with X-Environment. Revoke a token to disable it immediately.