Skip to main content
VESSL Cloud uses a two-level hierarchy for access control: organizations contain teams. Most commands operate within the context of your currently selected org and team.

Organization commands

org list

List all organizations you belong to.
vesslctl org list

org show

Display details about an organization. Defaults to the current org if no name is provided.
vesslctl org show [name]
ArgumentDescription
nameOrganization name (optional, defaults to current)

org switch

Switch your default organization context. Subsequent commands will operate under this org.
vesslctl org switch <name>
ArgumentDescription
nameOrganization name to switch to
Example:
vesslctl org switch vessl-ai

org create

Create a new organization.
vesslctl org create --name <name>
FlagRequiredDescription
--nameYesOrganization name
Example:
vesslctl org create --name my-org
The organization alias can be used interchangeably with org (for example, vesslctl organization list).

Team commands

team list

List all teams in your current organization.
vesslctl team list

team show

Display details about a team. Defaults to the current team if no name is provided.
vesslctl team show [name]
ArgumentDescription
nameTeam name (optional, defaults to current)

team switch

Switch your default team context.
vesslctl team switch <name>
ArgumentDescription
nameTeam name to switch to
Example:
vesslctl team switch ml-research

team create

Create a new team in your current organization.
vesslctl team create --name <name>
FlagRequiredDescription
--nameYesTeam name
--descriptionNoTeam description
Example:
vesslctl team create --name ml-research --description "Machine learning research team"