feat(api): manual updates

Author: stainless-app[bot]

.devcontainer/Dockerfile

@@ -1,20 +1,7 @@
 // For format details, see https://aka.ms/devcontainer.json. For config options, see the
 // README at: https://github.com/devcontainers/templates/tree/main/src/debian
 {
-  "name": "Debian",
-  "build": {
-    "dockerfile": "Dockerfile"
-  }
-
-  // Features to add to the dev container. More info: https://containers.dev/features.
-  // "features": {},
-
-  // Use 'forwardPorts' to make a list of ports inside the container available locally.
-  // "forwardPorts": [],
-
-  // Configure tool-specific properties.
-  // "customizations": {},
-
-  // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
-  // "remoteUser": "root"
+  "name": "Development",
+  "image": "mcr.microsoft.com/devcontainers/go:1.23-bookworm",
+  "postCreateCommand": "go mod tidy"
 }

.devcontainer/devcontainer.json

@@ -1,4 +1,4 @@
-configured_endpoints: 116
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-2e6ddfc9da00e33fcf13baf0b67012b97f051fa986658ff114fde989e56caa94.yml
-openapi_spec_hash: 5af02ea2008312d609394e548756e761
-config_hash: 60929489bdc1eaf979e7ef74fdd17b94
+configured_endpoints: 119
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-c850a6432597255fc1b788ba21a0494162e639f41dd80c0f9d07def239d31865.yml
+openapi_spec_hash: fba3f62e51d3ba39eea280abe29f39f1
+config_hash: 8e3b8fba844b78950ad4a13b75b7fffc

.stats.yml

@@ -16,11 +16,11 @@ before making any information public.
 ## Reporting Non-SDK Related Security Issues
 
 If you encounter security issues that are not directly related to SDKs but pertain to the services
-or products provided by Gitpod please follow the respective company's security reporting guidelines.
+or products provided by Gitpod, please follow the respective company's security reporting guidelines.
 
 ### Gitpod Terms and Policies
 
-Please contact dev-feedback@gitpod.com for any questions or concerns regarding security of our services.
+Please contact dev-feedback@gitpod.com for any questions or concerns regarding the security of our services.
 
 ---
 

SECURITY.md

@@ -120,6 +120,30 @@ func (r *AccountService) GetSSOLoginURL(ctx context.Context, body AccountGetSSOL
 	return
 }
 
+// Lists organizations that the currently authenticated account can join.
+//
+// Use this method to:
+//
+// - Discover organizations associated with the account's email domain.
+// - Allow users to join existing organizations.
+// - Display potential organizations during onboarding.
+//
+// ### Examples
+//
+// - List joinable organizations:
+//
+//	Retrieves a list of organizations the account can join.
+//
+//	```yaml
+//	{}
+//	```
+func (r *AccountService) ListJoinableOrganizations(ctx context.Context, params AccountListJoinableOrganizationsParams, opts ...option.RequestOption) (res *AccountListJoinableOrganizationsResponse, err error) {
+	opts = append(r.Options[:], opts...)
+	path := "gitpod.v1.AccountService/ListJoinableOrganizations"
+	err = requestconfig.ExecuteNewRequest(ctx, http.MethodPost, path, params, &res, opts...)
+	return
+}
+
 // Lists available login providers with optional filtering.
 //
 // Use this method to:
@@ -380,8 +404,11 @@ type Account struct {
 	// Joda Time's
 	// [`ISODateTimeFormat.dateTime()`](<http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime()>)
 	// to obtain a formatter capable of generating timestamps in this format.
-	UpdatedAt   time.Time              `json:"updatedAt,required" format:"date-time"`
-	AvatarURL   string                 `json:"avatarUrl"`
+	UpdatedAt time.Time `json:"updatedAt,required" format:"date-time"`
+	AvatarURL string    `json:"avatarUrl"`
+	// joinables is deprecated. Use ListJoinableOrganizations instead.
+	//
+	// Deprecated: deprecated
 	Joinables   []JoinableOrganization `json:"joinables"`
 	Memberships []AccountMembership    `json:"memberships"`
 	// organization_id is the ID of the organization the account is owned by if it's
@@ -552,6 +579,27 @@ func (r accountGetSSOLoginURLResponseJSON) RawJSON() string {
 	return r.raw
 }
 
+type AccountListJoinableOrganizationsResponse struct {
+	JoinableOrganizations []JoinableOrganization                       `json:"joinableOrganizations"`
+	JSON                  accountListJoinableOrganizationsResponseJSON `json:"-"`
+}
+
+// accountListJoinableOrganizationsResponseJSON contains the JSON metadata for the
+// struct [AccountListJoinableOrganizationsResponse]
+type accountListJoinableOrganizationsResponseJSON struct {
+	JoinableOrganizations apijson.Field
+	raw                   string
+	ExtraFields           map[string]apijson.Field
+}
+
+func (r *AccountListJoinableOrganizationsResponse) UnmarshalJSON(data []byte) (err error) {
+	return apijson.UnmarshalRoot(data, r)
+}
+
+func (r accountListJoinableOrganizationsResponseJSON) RawJSON() string {
+	return r.raw
+}
+
 type AccountGetParams struct {
 	Empty param.Field[bool] `json:"empty"`
 }
@@ -579,6 +627,25 @@ func (r AccountGetSSOLoginURLParams) MarshalJSON() (data []byte, err error) {
 	return apijson.MarshalRoot(r)
 }
 
+type AccountListJoinableOrganizationsParams struct {
+	Token    param.Field[string] `query:"token"`
+	PageSize param.Field[int64]  `query:"pageSize"`
+	Empty    param.Field[bool]   `json:"empty"`
+}
+
+func (r AccountListJoinableOrganizationsParams) MarshalJSON() (data []byte, err error) {
+	return apijson.MarshalRoot(r)
+}
+
+// URLQuery serializes [AccountListJoinableOrganizationsParams]'s query parameters
+// as `url.Values`.
+func (r AccountListJoinableOrganizationsParams) URLQuery() (v url.Values) {
+	return apiquery.MarshalWithSettings(r, apiquery.QuerySettings{
+		ArrayFormat:  apiquery.ArrayQueryFormatComma,
+		NestedFormat: apiquery.NestedQueryFormatBrackets,
+	})
+}
+
 type AccountListLoginProvidersParams struct {
 	Token    param.Field[string] `query:"token"`
 	PageSize param.Field[int64]  `query:"pageSize"`

account.go

@@ -89,6 +89,33 @@ func TestAccountGetSSOLoginURLWithOptionalParams(t *testing.T) {
 	}
 }
 
+func TestAccountListJoinableOrganizationsWithOptionalParams(t *testing.T) {
+	t.Skip("skipped: tests are disabled for the time being")
+	baseURL := "http://localhost:4010"
+	if envURL, ok := os.LookupEnv("TEST_API_BASE_URL"); ok {
+		baseURL = envURL
+	}
+	if !testutil.CheckTestServer(t, baseURL) {
+		return
+	}
+	client := gitpod.NewClient(
+		option.WithBaseURL(baseURL),
+		option.WithBearerToken("My Bearer Token"),
+	)
+	_, err := client.Accounts.ListJoinableOrganizations(context.TODO(), gitpod.AccountListJoinableOrganizationsParams{
+		Token:    gitpod.F("token"),
+		PageSize: gitpod.F(int64(0)),
+		Empty:    gitpod.F(true),
+	})
+	if err != nil {
+		var apierr *gitpod.Error
+		if errors.As(err, &apierr) {
+			t.Log(string(apierr.DumpRequest(true)))
+		}
+		t.Fatalf("err should be nil: %s", err.Error())
+	}
+}
+
 func TestAccountListLoginProvidersWithOptionalParams(t *testing.T) {
 	t.Skip("skipped: tests are disabled for the time being")
 	baseURL := "http://localhost:4010"

account_test.go

@@ -55,6 +55,11 @@ type FieldValue = shared.FieldValue
 // This is an alias to an internal type.
 type FieldValueParam = shared.FieldValueParam
 
+// Gateway represents a system gateway that provides access to services
+//
+// This is an alias to an internal type.
+type Gateway = shared.Gateway
+
 // This is an alias to an internal type.
 type OrganizationRole = shared.OrganizationRole
 
@@ -88,6 +93,9 @@ const PrincipalEnvironment = shared.PrincipalEnvironment
 // This is an alias to an internal value.
 const PrincipalServiceAccount = shared.PrincipalServiceAccount
 
+// This is an alias to an internal value.
+const PrincipalRunnerManager = shared.PrincipalRunnerManager
+
 // This is an alias to an internal type.
 type RunsOn = shared.RunsOn