Function resolveAPIAppLink

internal/cli/quickstarts.go:726–783

resolveAPIAppLink handles the API flow's app-linking decision. It either sets inputs.LinkedAppID (via picker or flag) or flips inputs.App=true so the regular App-creation flow runs and the new client ID is assigned later.

(
	cmd *cobra.Command,
	cli *cli,
	inputs *SetupInputs,
	canPromptFlag bool,
)

// It either sets inputs.LinkedAppID (via picker or flag) or flips inputs.App=true
// so the regular App-creation flow runs and the new client ID is assigned later.
func resolveAPIAppLink(
	cmd *cobra.Command,
	cli *cli,
	inputs *SetupInputs,
	canPromptFlag bool,
) error {
	if !inputs.API {
		return nil
	}

	// --app and --api both set: create a new app and link it.
	if inputs.App {
		return nil
	}

	// --linked-app-id flag already provided.
	if inputs.LinkedAppID != "" {
		return nil
	}

	if !canPromptFlag {
		return fmt.Errorf("in --no-input mode with --api, specify --app to create a new app or --linked-app-id <client-id> to link an existing one")
	}

	const (
		actionCreateNew = "Create a new app"
		actionLink      = "Link to an existing app"
	)

	var action string
	actionQ := prompt.SelectInput(
		"link-app-action",
		"How should this API be associated with an app?",
		"Create a new app to link with the API, or link to an existing one in the tenant.",
		[]string{actionCreateNew, actionLink},
		actionCreateNew,
		true,
	)
	if err := prompt.AskOne(actionQ, &action); err != nil {
		return fmt.Errorf("failed to select link action: %w", err)
	}

	if action == actionCreateNew {
		inputs.App = true
		return nil
	}

	// Link to an existing app via the standard app picker.
	appPicker := Argument{
		Name: "Application",
		Help: "Select an existing application to authorize for this API.",
	}
	return appPicker.Pick(
		cmd,
		&inputs.LinkedAppID,
		cli.appPickerOptions(management.Parameter("app_type", "native,spa,regular_web")),
	)
}