feat: add CLI command to get and update organizations (#3763)

Closes #3634 

 ## Summary

- Add `superplane organizations get` command to view current
organization details
- Add `superplane organizations update` command with `--name`,
`--description`, and `--versioning-enabled` flags
- Register new `organizations` command (aliases: `org`, `orgs`) in the
CLI root

  ## Usage

  ```sh
  superplane org get
  superplane org update --name "My Org"
superplane org update --description "New description"
--versioning-enabled=true
```

  Test plan

  - superplane org get returns organization details in text/json/yaml formats
  - superplane org update --name "Test" updates only the name
  - superplane org update --description "Desc" updates only the description
  - superplane org update --versioning-enabled=false disables versioning
  - superplane org update with no flags returns an error
  - superplane org update --name "duplicate" with a taken name returns an error
  - make lint && make check.build.app pass
  

 ## Command output

<img width="943" height="138" alt="Screenshot 2026-03-27 153009" src="https://github.com/user-attachments/assets/9c1452be-8518-413f-8bd7-6f21aa6a8789" />

<img width="601" height="135" alt="Screenshot 2026-03-27 152941" src="https://github.com/user-attachments/assets/30752eee-88df-4952-ad55-b735e4ad64f5" />

<img width="443" height="140" alt="Screenshot 2026-03-27 152901" src="https://github.com/user-attachments/assets/37547dcb-75ca-4beb-95ae-85405581dd5b" />

---------

Signed-off-by: Vukotije <vukanradojevicc@gmail.com>
Co-authored-by: Pedro Leão <60622592+forestileao@users.noreply.github.com>

Author: Vukotije

pkg/cli/commands/organizations/common.go

@@ -0,0 +1,26 @@
+package organizations
+
+import (
+	"fmt"
+	"io"
+	"time"
+
+	"github.com/superplanehq/superplane/pkg/openapi_client"
+)
+
+func renderOrganization(stdout io.Writer, org openapi_client.OrganizationsOrganization) error {
+	metadata := org.GetMetadata()
+
+	_, _ = fmt.Fprintf(stdout, "ID: %s\n", metadata.GetId())
+	_, _ = fmt.Fprintf(stdout, "Name: %s\n", metadata.GetName())
+	_, _ = fmt.Fprintf(stdout, "Description: %s\n", metadata.GetDescription())
+	_, _ = fmt.Fprintf(stdout, "Versioning Enabled: %t\n", metadata.GetVersioningEnabled())
+	if metadata.HasCreatedAt() {
+		_, _ = fmt.Fprintf(stdout, "Created At: %s\n", metadata.GetCreatedAt().Format(time.RFC3339))
+	}
+	if metadata.HasUpdatedAt() {
+		_, _ = fmt.Fprintf(stdout, "Updated At: %s\n", metadata.GetUpdatedAt().Format(time.RFC3339))
+	}
+
+	return nil
+}

pkg/cli/commands/organizations/get.go

@@ -0,0 +1,32 @@
+package organizations
+
+import (
+	"io"
+
+	"github.com/superplanehq/superplane/pkg/cli/core"
+)
+
+type getCommand struct{}
+
+func (c *getCommand) Execute(ctx core.CommandContext) error {
+	organizationID, err := core.ResolveOrganizationID(ctx)
+	if err != nil {
+		return err
+	}
+
+	response, _, err := ctx.API.OrganizationAPI.
+		OrganizationsDescribeOrganization(ctx.Context, organizationID).
+		Execute()
+	if err != nil {
+		return err
+	}
+
+	if !ctx.Renderer.IsText() {
+		return ctx.Renderer.Render(response)
+	}
+
+	org := response.GetOrganization()
+	return ctx.Renderer.RenderText(func(stdout io.Writer) error {
+		return renderOrganization(stdout, org)
+	})
+}

pkg/cli/commands/organizations/root.go

@@ -0,0 +1,43 @@
+package organizations
+
+import (
+	"github.com/spf13/cobra"
+	"github.com/superplanehq/superplane/pkg/cli/core"
+)
+
+func NewCommand(options core.BindOptions) *cobra.Command {
+	root := &cobra.Command{
+		Use:     "organizations",
+		Short:   "Manage organizations",
+		Aliases: []string{"org", "orgs"},
+	}
+
+	getCmd := &cobra.Command{
+		Use:   "get",
+		Short: "Get details for the current organization",
+		Args:  cobra.NoArgs,
+	}
+	core.Bind(getCmd, &getCommand{}, options)
+
+	var updateName string
+	var updateDescription string
+	var updateVersioningEnabled bool
+	updateCmd := &cobra.Command{
+		Use:   "update",
+		Short: "Update the current organization",
+		Args:  cobra.NoArgs,
+	}
+	updateCmd.Flags().StringVar(&updateName, "name", "", "organization name")
+	updateCmd.Flags().StringVar(&updateDescription, "description", "", "organization description")
+	updateCmd.Flags().BoolVar(&updateVersioningEnabled, "versioning-enabled", false, "enable or disable global versioning")
+	core.Bind(updateCmd, &updateCommand{
+		name:              &updateName,
+		description:       &updateDescription,
+		versioningEnabled: &updateVersioningEnabled,
+	}, options)
+
+	root.AddCommand(getCmd)
+	root.AddCommand(updateCmd)
+
+	return root
+}

pkg/cli/commands/organizations/update.go

@@ -0,0 +1,62 @@
+package organizations
+
+import (
+	"fmt"
+	"io"
+
+	"github.com/superplanehq/superplane/pkg/cli/core"
+	"github.com/superplanehq/superplane/pkg/openapi_client"
+)
+
+type updateCommand struct {
+	name              *string
+	description       *string
+	versioningEnabled *bool
+}
+
+func (c *updateCommand) Execute(ctx core.CommandContext) error {
+	if !ctx.Cmd.Flags().Changed("name") &&
+		!ctx.Cmd.Flags().Changed("description") &&
+		!ctx.Cmd.Flags().Changed("versioning-enabled") {
+		return fmt.Errorf("at least one flag must be provided: --name, --description, or --versioning-enabled")
+	}
+
+	organizationID, err := core.ResolveOrganizationID(ctx)
+	if err != nil {
+		return err
+	}
+
+	metadata := openapi_client.OrganizationsOrganizationMetadata{}
+	if ctx.Cmd.Flags().Changed("name") {
+		metadata.SetName(*c.name)
+	}
+	if ctx.Cmd.Flags().Changed("description") {
+		metadata.SetDescription(*c.description)
+	}
+	if ctx.Cmd.Flags().Changed("versioning-enabled") {
+		metadata.SetVersioningEnabled(*c.versioningEnabled)
+	}
+
+	org := openapi_client.OrganizationsOrganization{}
+	org.SetMetadata(metadata)
+
+	body := openapi_client.OrganizationsUpdateOrganizationBody{}
+	body.SetOrganization(org)
+
+	response, _, err := ctx.API.OrganizationAPI.
+		OrganizationsUpdateOrganization(ctx.Context, organizationID).
+		Body(body).
+		Execute()
+	if err != nil {
+		return err
+	}
+
+	if !ctx.Renderer.IsText() {
+		return ctx.Renderer.Render(response)
+	}
+
+	updated := response.GetOrganization()
+	return ctx.Renderer.RenderText(func(stdout io.Writer) error {
+		return renderOrganization(stdout, updated)
+	})
+}

pkg/cli/commands/secrets/common.go

@@ -5,7 +5,6 @@ import (
 	"io"
 	"os"
 	"sort"
-	"strings"
 	"text/tabwriter"
 	"time"
 
@@ -25,19 +24,6 @@ type secretResource struct {
 	Spec       *openapi_client.SecretsSecretSpec     `json:"spec,omitempty"`
 }
 
-func resolveOrganizationID(ctx core.CommandContext) (string, error) {
-	me, _, err := ctx.API.MeAPI.MeMe(ctx.Context).Execute()
-	if err != nil {
-		return "", err
-	}
-
-	if !me.HasOrganizationId() || strings.TrimSpace(me.GetOrganizationId()) == "" {
-		return "", fmt.Errorf("organization id not found for authenticated user")
-	}
-
-	return me.GetOrganizationId(), nil
-}
-
 func organizationDomainType() openapi_client.AuthorizationDomainType {
 	return openapi_client.AUTHORIZATIONDOMAINTYPE_DOMAIN_TYPE_ORGANIZATION
 }

pkg/cli/commands/secrets/create.go

@@ -21,7 +21,7 @@ func (c *createCommand) Execute(ctx core.CommandContext) error {
 		return fmt.Errorf("--file is required")
 	}
 
-	organizationID, err := resolveOrganizationID(ctx)
+	organizationID, err := core.ResolveOrganizationID(ctx)
 	if err != nil {
 		return err
 	}

pkg/cli/commands/secrets/delete.go

@@ -10,7 +10,7 @@ import (
 type deleteCommand struct{}
 
 func (c *deleteCommand) Execute(ctx core.CommandContext) error {
-	organizationID, err := resolveOrganizationID(ctx)
+	organizationID, err := core.ResolveOrganizationID(ctx)
 	if err != nil {
 		return err
 	}

pkg/cli/commands/secrets/get.go

@@ -9,7 +9,7 @@ import (
 type getCommand struct{}
 
 func (c *getCommand) Execute(ctx core.CommandContext) error {
-	organizationID, err := resolveOrganizationID(ctx)
+	organizationID, err := core.ResolveOrganizationID(ctx)
 	if err != nil {
 		return err
 	}

pkg/cli/commands/secrets/list.go

@@ -9,7 +9,7 @@ import (
 type listCommand struct{}
 
 func (c *listCommand) Execute(ctx core.CommandContext) error {
-	organizationID, err := resolveOrganizationID(ctx)
+	organizationID, err := core.ResolveOrganizationID(ctx)
 	if err != nil {
 		return err
 	}

pkg/cli/commands/secrets/update.go

@@ -24,7 +24,7 @@ func (c *updateCommand) Execute(ctx core.CommandContext) error {
 		return fmt.Errorf("update does not accept positional arguments")
 	}
 
-	organizationID, err := resolveOrganizationID(ctx)
+	organizationID, err := core.ResolveOrganizationID(ctx)
 	if err != nil {
 		return err
 	}