Skip to content
Spinbox is experimental: APIs change and data may be lost. Status lists what is built and what proves it.

spin team

View Markdown
Manage teams and team membership.
Teams provide hierarchical grouping of users and workspaces. Teams can be
nested up to 3 levels deep (e.g., /engineering/backend/api).
Usage:
spin team [flags]
spin team [command]
Available Commands:
create Create a new team
delete Delete a team
get Get team details
list List teams
member Manage team members
policy Manage the network policies a team's workspaces may run under
secret Manage the secrets the egress proxy adds for a team's workspaces
Flags:
-h, --help[=true|false] help for team
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
Use "spin team [command] --help" for more information about a command.
Create a new team. Use --parent to nest under an existing team.
Examples:
spin team create engineering
spin team create backend --parent engineering
spin team create api --parent /engineering/backend
Usage:
spin team create <name> [flags]
Flags:
--description string Team description
-h, --help[=true|false] help for create
--parent string Parent team ID or path
--slug string URL-friendly slug (auto-generated if empty)
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
Delete a team. Only team owners can delete teams.
Teams with children cannot be deleted unless --recursive is used.
Usage:
spin team delete <team> [flags]
Flags:
-h, --help[=true|false] help for delete
--recursive[=true|false] Delete children too (dangerous!)
-y, --yes[=true|false] Skip confirmation
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
Get team details
Usage:
spin team get <team> [flags]
Flags:
-h, --help[=true|false] help for get
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
List teams
Usage:
spin team list [flags]
Flags:
--all[=true|false] Include all descendant teams
-h, --help[=true|false] help for list
--parent string Filter by parent team
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
Manage team members
Usage:
spin team member [flags]
spin team member [command]
Available Commands:
add Add a member to a team
list List team members
remove Remove a member from a team
role Update a member's role
Flags:
-h, --help[=true|false] help for member
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
Use "spin team member [command] --help" for more information about a command.
Add a member to a team
Usage:
spin team member add <team> <email> [flags]
Flags:
-h, --help[=true|false] help for add
--role string Role: owner, admin, member (default "member")
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
List team members
Usage:
spin team member list <team> [flags]
Flags:
-h, --help[=true|false] help for list
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
Remove a member from a team
Usage:
spin team member remove <team> <user-id> [flags]
Flags:
-h, --help[=true|false] help for remove
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
Update a member's role
Usage:
spin team member role <team> <user-id> <role> [flags]
Flags:
-h, --help[=true|false] help for role
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
A team's network policies are named allowlists, declared by its admins where the
installation lets teams declare them, for the workspaces of the team and of the teams below it.
A workspace runs under one by naming it (spin workspace create --network-tag, spin workspace
retag). They only allow: a brokered rule is the installation's to declare.
Usage:
spin team policy [flags]
spin team policy [command]
Available Commands:
delete Delete a team's network policy no workspace runs under
list List a team's network policies and what each allows
set Make a team's policy, or replace what it allows
Flags:
-h, --help[=true|false] help for policy
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
Use "spin team policy [command] --help" for more information about a command.
Delete a team's network policy no workspace runs under
Usage:
spin team policy delete <team> <name> [flags]
Flags:
-h, --help[=true|false] help for delete
-y, --yes[=true|false] Skip confirmation
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
List a team's network policies and what each allows
Usage:
spin team policy list <team> [flags]
Flags:
-h, --help[=true|false] help for list
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
Make a team's policy, or replace what it allows, whole. Each --rule is destinations, then
the ports they are reached on after a colon: CIDRs or addresses, and names - exact or with one
leading "*." - separated by commas. No ports is every port; no destinations is any destination
on those ports. No --rule at all allows nothing.
Example:
spin team policy set <team> builds --rule github.com,*.githubusercontent.com:443 --rule 10.20.0.0/16:5432
Usage:
spin team policy set <team> <name> [flags]
Flags:
-h, --help[=true|false] help for set
--rule stringArray Destinations and ports, as dest,dest:port,port (repeatable)
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
A team's secrets are what a brokered network rule has the host's egress proxy add to a
request a workspace of the team makes - an API key the workspace uses without ever holding it.
A value is set and replaced, and not shown again; it is sent only to the hosts set with it. A
workspace of a sub-team uses the nearest of its teams that has the name. The installation's
admins, who write the policies, are trusted with it.
Usage:
spin team secret [flags]
spin team secret [command]
Available Commands:
delete Delete a team's secret
list List a team's secrets, by name
set Set a team's secret, read from standard input or kept in Secrets Manager or Parameter Store
Flags:
-h, --help[=true|false] help for secret
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
Use "spin team secret [command] --help" for more information about a command.
Delete a team's secret
Usage:
spin team secret delete <team> <name> [flags]
Flags:
-h, --help[=true|false] help for delete
-y, --yes[=true|false] Skip confirmation
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
List a team's secrets, by name
Usage:
spin team secret list <team> [flags]
Flags:
-h, --help[=true|false] help for list
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
Set a team's secret to what standard input holds, and the hosts it may be sent to, replacing
what the name held. Read from standard input and never an argument: an argument is in every
process listing on the machine. A brokered rule that injects the secret and names any host not
given here is refused it.
With --ref the team keeps the value in Secrets Manager or Parameter Store instead, and the control
plane reads it as the team whenever a host asks: the secret or the parameter must carry the tag
spin-team-id with the team's id. A parameter costs nothing; a SecureString is opened on the read.
Example:
printf %s "$GITHUB_TOKEN" | spin team secret set engineering github --host api.github.com
spin team secret set engineering github --host api.github.com \
--ref arn:aws:secretsmanager:us-east-2:123456789012:secret:github-AbCdEf
Usage:
spin team secret set <team> <name> [flags]
Flags:
-h, --help[=true|false] help for set
--host stringArray A host the secret may be sent to, named exactly (repeatable)
--ref string The ARN of the Secrets Manager secret or the Parameter Store parameter the team keeps the value in
Global Flags:
--config string config file (default is $HOME/.spin/config.yaml)
-o, --output string text for a person, or json: one document of what the API answered, and no prose (default "text")
--profile string named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
--traceparent string the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false

Generated by task reference from spin/cmd/cli at 51f7e0dea.

Installations run Spinbox v20261027.01; the reference is generated from spin v20261114.01 (51f7e0dea). This page as Markdown, for a model or a terminal.