From c6c25ee75f1ef42b2cbe23bf4fe824f4ada6926e Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Sat, 15 Aug 2026 02:24:31 +0000 Subject: [PATCH] Update generated API client --- v2/api/admin/admin_request_builder.go | 5 + .../github_app_installations_get_response.go | 125 +++++++++++++++ ...installations_get_response_escaped_meta.go | 113 +++++++++++++ ...p_installations_refresh_request_builder.go | 57 +++++++ ...ithub_app_installations_request_builder.go | 80 ++++++++++ .../get_filter_status_query_parameter_type.go | 42 +++++ .../get_filter_type_query_parameter_type.go | 36 +++++ v2/api/kiota-lock.json | 2 +- ...ub_app_installations_escaped_attributes.go | 58 +++++++ v2/api/models/policy_sets_envelope.go | 6 +- .../policy_sets_envelope_escaped_included.go | 2 +- .../scim_identities_escaped_attributes.go | 23 +++ ..._relationships_policies_request_builder.go | 4 +- v2/openapi/spec.json | 150 +++++++++++++++++- 14 files changed, 692 insertions(+), 11 deletions(-) create mode 100644 v2/api/admin/github_app_installations_get_response.go create mode 100644 v2/api/admin/github_app_installations_get_response_escaped_meta.go create mode 100644 v2/api/admin/github_app_installations_refresh_request_builder.go create mode 100644 v2/api/admin/github_app_installations_request_builder.go create mode 100644 v2/api/admin/githubappinstallations/get_filter_status_query_parameter_type.go create mode 100644 v2/api/admin/githubappinstallations/get_filter_type_query_parameter_type.go diff --git a/v2/api/admin/admin_request_builder.go b/v2/api/admin/admin_request_builder.go index bedc9ab2b..1a10428ce 100644 --- a/v2/api/admin/admin_request_builder.go +++ b/v2/api/admin/admin_request_builder.go @@ -29,3 +29,8 @@ func NewAdminRequestBuilder(rawUrl string, requestAdapter i2ae4187f7daee263371cb urlParams["request-raw-url"] = rawUrl return NewAdminRequestBuilderInternal(urlParams, requestAdapter) } +// GithubAppInstallations the githubAppInstallations property +// returns a *GithubAppInstallationsRequestBuilder when successful +func (m *AdminRequestBuilder) GithubAppInstallations()(*GithubAppInstallationsRequestBuilder) { + return NewGithubAppInstallationsRequestBuilderInternal(m.BaseRequestBuilder.PathParameters, m.BaseRequestBuilder.RequestAdapter) +} diff --git a/v2/api/admin/github_app_installations_get_response.go b/v2/api/admin/github_app_installations_get_response.go new file mode 100644 index 000000000..542710e59 --- /dev/null +++ b/v2/api/admin/github_app_installations_get_response.go @@ -0,0 +1,125 @@ +// Code generated by Microsoft Kiota - DO NOT EDIT. +// Changes may cause incorrect behavior and will be lost if the code is regenerated. + +package admin + +import ( + i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91 "github.com/microsoft/kiota-abstractions-go/serialization" + i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16 "github.com/hashicorp/go-tfe/v2/api/models" +) + +type GithubAppInstallationsGetResponse struct { + // Stores additional data not described in the OpenAPI description found when deserializing. Can be used for serialization as well. + additionalData map[string]any + // The data property + data []i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.GithubAppInstallationsable + // The meta property + meta GithubAppInstallationsGetResponse_metaable +} +// NewGithubAppInstallationsGetResponse instantiates a new GithubAppInstallationsGetResponse and sets the default values. +func NewGithubAppInstallationsGetResponse()(*GithubAppInstallationsGetResponse) { + m := &GithubAppInstallationsGetResponse{ + } + m.SetAdditionalData(make(map[string]any)) + return m +} +// CreateGithubAppInstallationsGetResponseFromDiscriminatorValue creates a new instance of the appropriate class based on discriminator value +// returns a Parsable when successful +func CreateGithubAppInstallationsGetResponseFromDiscriminatorValue(parseNode i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode)(i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.Parsable, error) { + return NewGithubAppInstallationsGetResponse(), nil +} +// GetAdditionalData gets the AdditionalData property value. Stores additional data not described in the OpenAPI description found when deserializing. Can be used for serialization as well. +// returns a map[string]any when successful +func (m *GithubAppInstallationsGetResponse) GetAdditionalData()(map[string]any) { + return m.additionalData +} +// GetData gets the data property value. The data property +// returns a []GithubAppInstallationsable when successful +func (m *GithubAppInstallationsGetResponse) GetData()([]i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.GithubAppInstallationsable) { + return m.data +} +// GetFieldDeserializers the deserialization information for the current model +// returns a map[string]func(i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode)(error) when successful +func (m *GithubAppInstallationsGetResponse) GetFieldDeserializers()(map[string]func(i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode)(error)) { + res := make(map[string]func(i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode)(error)) + res["data"] = func (n i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode) error { + val, err := n.GetCollectionOfObjectValues(i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.CreateGithubAppInstallationsFromDiscriminatorValue) + if err != nil { + return err + } + if val != nil { + res := make([]i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.GithubAppInstallationsable, len(val)) + for i, v := range val { + if v != nil { + res[i] = v.(i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.GithubAppInstallationsable) + } + } + m.SetData(res) + } + return nil + } + res["meta"] = func (n i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode) error { + val, err := n.GetObjectValue(CreateGithubAppInstallationsGetResponse_metaFromDiscriminatorValue) + if err != nil { + return err + } + if val != nil { + m.SetMeta(val.(GithubAppInstallationsGetResponse_metaable)) + } + return nil + } + return res +} +// GetMeta gets the meta property value. The meta property +// returns a GithubAppInstallationsGetResponse_metaable when successful +func (m *GithubAppInstallationsGetResponse) GetMeta()(GithubAppInstallationsGetResponse_metaable) { + return m.meta +} +// Serialize serializes information the current object +func (m *GithubAppInstallationsGetResponse) Serialize(writer i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.SerializationWriter)(error) { + if m.GetData() != nil { + cast := make([]i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.Parsable, len(m.GetData())) + for i, v := range m.GetData() { + if v != nil { + cast[i] = v.(i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.Parsable) + } + } + err := writer.WriteCollectionOfObjectValues("data", cast) + if err != nil { + return err + } + } + { + err := writer.WriteObjectValue("meta", m.GetMeta()) + if err != nil { + return err + } + } + { + err := writer.WriteAdditionalData(m.GetAdditionalData()) + if err != nil { + return err + } + } + return nil +} +// SetAdditionalData sets the AdditionalData property value. Stores additional data not described in the OpenAPI description found when deserializing. Can be used for serialization as well. +func (m *GithubAppInstallationsGetResponse) SetAdditionalData(value map[string]any)() { + m.additionalData = value +} +// SetData sets the data property value. The data property +func (m *GithubAppInstallationsGetResponse) SetData(value []i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.GithubAppInstallationsable)() { + m.data = value +} +// SetMeta sets the meta property value. The meta property +func (m *GithubAppInstallationsGetResponse) SetMeta(value GithubAppInstallationsGetResponse_metaable)() { + m.meta = value +} +type GithubAppInstallationsGetResponseable interface { + i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.AdditionalDataHolder + i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.Parsable + GetData()([]i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.GithubAppInstallationsable) + GetMeta()(GithubAppInstallationsGetResponse_metaable) + SetData(value []i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.GithubAppInstallationsable)() + SetMeta(value GithubAppInstallationsGetResponse_metaable)() +} diff --git a/v2/api/admin/github_app_installations_get_response_escaped_meta.go b/v2/api/admin/github_app_installations_get_response_escaped_meta.go new file mode 100644 index 000000000..2939de5d1 --- /dev/null +++ b/v2/api/admin/github_app_installations_get_response_escaped_meta.go @@ -0,0 +1,113 @@ +// Code generated by Microsoft Kiota - DO NOT EDIT. +// Changes may cause incorrect behavior and will be lost if the code is regenerated. + +package admin + +import ( + i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91 "github.com/microsoft/kiota-abstractions-go/serialization" + i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16 "github.com/hashicorp/go-tfe/v2/api/models" +) + +type GithubAppInstallationsGetResponse_meta struct { + // Stores additional data not described in the OpenAPI description found when deserializing. Can be used for serialization as well. + additionalData map[string]any + // The pagination property + pagination i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.Paginationable + // The unfiltered number of synchronized installations for the app, independent of the filter and page parameters. + totalInstallationCount *int32 +} +// NewGithubAppInstallationsGetResponse_meta instantiates a new GithubAppInstallationsGetResponse_meta and sets the default values. +func NewGithubAppInstallationsGetResponse_meta()(*GithubAppInstallationsGetResponse_meta) { + m := &GithubAppInstallationsGetResponse_meta{ + } + m.SetAdditionalData(make(map[string]any)) + return m +} +// CreateGithubAppInstallationsGetResponse_metaFromDiscriminatorValue creates a new instance of the appropriate class based on discriminator value +// returns a Parsable when successful +func CreateGithubAppInstallationsGetResponse_metaFromDiscriminatorValue(parseNode i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode)(i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.Parsable, error) { + return NewGithubAppInstallationsGetResponse_meta(), nil +} +// GetAdditionalData gets the AdditionalData property value. Stores additional data not described in the OpenAPI description found when deserializing. Can be used for serialization as well. +// returns a map[string]any when successful +func (m *GithubAppInstallationsGetResponse_meta) GetAdditionalData()(map[string]any) { + return m.additionalData +} +// GetFieldDeserializers the deserialization information for the current model +// returns a map[string]func(i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode)(error) when successful +func (m *GithubAppInstallationsGetResponse_meta) GetFieldDeserializers()(map[string]func(i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode)(error)) { + res := make(map[string]func(i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode)(error)) + res["pagination"] = func (n i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode) error { + val, err := n.GetObjectValue(i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.CreatePaginationFromDiscriminatorValue) + if err != nil { + return err + } + if val != nil { + m.SetPagination(val.(i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.Paginationable)) + } + return nil + } + res["total-installation-count"] = func (n i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode) error { + val, err := n.GetInt32Value() + if err != nil { + return err + } + if val != nil { + m.SetTotalInstallationCount(val) + } + return nil + } + return res +} +// GetPagination gets the pagination property value. The pagination property +// returns a Paginationable when successful +func (m *GithubAppInstallationsGetResponse_meta) GetPagination()(i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.Paginationable) { + return m.pagination +} +// GetTotalInstallationCount gets the total-installation-count property value. The unfiltered number of synchronized installations for the app, independent of the filter and page parameters. +// returns a *int32 when successful +func (m *GithubAppInstallationsGetResponse_meta) GetTotalInstallationCount()(*int32) { + return m.totalInstallationCount +} +// Serialize serializes information the current object +func (m *GithubAppInstallationsGetResponse_meta) Serialize(writer i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.SerializationWriter)(error) { + { + err := writer.WriteObjectValue("pagination", m.GetPagination()) + if err != nil { + return err + } + } + { + err := writer.WriteInt32Value("total-installation-count", m.GetTotalInstallationCount()) + if err != nil { + return err + } + } + { + err := writer.WriteAdditionalData(m.GetAdditionalData()) + if err != nil { + return err + } + } + return nil +} +// SetAdditionalData sets the AdditionalData property value. Stores additional data not described in the OpenAPI description found when deserializing. Can be used for serialization as well. +func (m *GithubAppInstallationsGetResponse_meta) SetAdditionalData(value map[string]any)() { + m.additionalData = value +} +// SetPagination sets the pagination property value. The pagination property +func (m *GithubAppInstallationsGetResponse_meta) SetPagination(value i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.Paginationable)() { + m.pagination = value +} +// SetTotalInstallationCount sets the total-installation-count property value. The unfiltered number of synchronized installations for the app, independent of the filter and page parameters. +func (m *GithubAppInstallationsGetResponse_meta) SetTotalInstallationCount(value *int32)() { + m.totalInstallationCount = value +} +type GithubAppInstallationsGetResponse_metaable interface { + i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.AdditionalDataHolder + i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.Parsable + GetPagination()(i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.Paginationable) + GetTotalInstallationCount()(*int32) + SetPagination(value i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.Paginationable)() + SetTotalInstallationCount(value *int32)() +} diff --git a/v2/api/admin/github_app_installations_refresh_request_builder.go b/v2/api/admin/github_app_installations_refresh_request_builder.go new file mode 100644 index 000000000..d4b451719 --- /dev/null +++ b/v2/api/admin/github_app_installations_refresh_request_builder.go @@ -0,0 +1,57 @@ +// Code generated by Microsoft Kiota - DO NOT EDIT. +// Changes may cause incorrect behavior and will be lost if the code is regenerated. + +package admin + +import ( + "context" + i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f "github.com/microsoft/kiota-abstractions-go" + i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16 "github.com/hashicorp/go-tfe/v2/api/models" +) + +// GithubAppInstallationsRefreshRequestBuilder builds and executes requests for operations under \admin\github-app-installations\refresh +type GithubAppInstallationsRefreshRequestBuilder struct { + i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.BaseRequestBuilder +} +// NewGithubAppInstallationsRefreshRequestBuilderInternal instantiates a new GithubAppInstallationsRefreshRequestBuilder and sets the default values. +func NewGithubAppInstallationsRefreshRequestBuilderInternal(pathParameters map[string]string, requestAdapter i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.RequestAdapter)(*GithubAppInstallationsRefreshRequestBuilder) { + m := &GithubAppInstallationsRefreshRequestBuilder{ + BaseRequestBuilder: *i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.NewBaseRequestBuilder(requestAdapter, "{+baseurl}/admin/github-app-installations/refresh", pathParameters), + } + return m +} +// NewGithubAppInstallationsRefreshRequestBuilder instantiates a new GithubAppInstallationsRefreshRequestBuilder and sets the default values. +func NewGithubAppInstallationsRefreshRequestBuilder(rawUrl string, requestAdapter i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.RequestAdapter)(*GithubAppInstallationsRefreshRequestBuilder) { + urlParams := make(map[string]string) + urlParams["request-raw-url"] = rawUrl + return NewGithubAppInstallationsRefreshRequestBuilderInternal(urlParams, requestAdapter) +} +// Post request an on-demand reconciliation of the Global GitHub App's installation inventory against GitHub, recovering installations whose webhook deliveries were missed. Only available when the app is hosted on GHE.com. This endpoint is exclusive to Terraform Enterprise and requires site-admin access.This operation is only available in Terraform Enterprise. +// returns a Errors error when the service returns a 4XX or 5XX status code +func (m *GithubAppInstallationsRefreshRequestBuilder) Post(ctx context.Context, requestConfiguration *i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.RequestConfiguration[i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.DefaultQueryParameters])(error) { + requestInfo, err := m.ToPostRequestInformation(ctx, requestConfiguration); + if err != nil { + return err + } + errorMapping := i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.ErrorMappings { + "XXX": i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.CreateErrorsFromDiscriminatorValue, + } + err = m.BaseRequestBuilder.RequestAdapter.SendNoContent(ctx, requestInfo, errorMapping) + if err != nil { + return err + } + return nil +} +// ToPostRequestInformation request an on-demand reconciliation of the Global GitHub App's installation inventory against GitHub, recovering installations whose webhook deliveries were missed. Only available when the app is hosted on GHE.com. This endpoint is exclusive to Terraform Enterprise and requires site-admin access.This operation is only available in Terraform Enterprise. +// returns a *RequestInformation when successful +func (m *GithubAppInstallationsRefreshRequestBuilder) ToPostRequestInformation(ctx context.Context, requestConfiguration *i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.RequestConfiguration[i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.DefaultQueryParameters])(*i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.RequestInformation, error) { + requestInfo := i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.NewRequestInformationWithMethodAndUrlTemplateAndPathParameters(i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.POST, m.BaseRequestBuilder.UrlTemplate, m.BaseRequestBuilder.PathParameters) + i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.ConfigureRequestInformation(requestInfo, requestConfiguration) + requestInfo.Headers.TryAdd("Accept", "application/vnd.api+json") + return requestInfo, nil +} +// WithUrl returns a request builder with the provided arbitrary URL. Using this method means any other path or query parameters are ignored. +// returns a *GithubAppInstallationsRefreshRequestBuilder when successful +func (m *GithubAppInstallationsRefreshRequestBuilder) WithUrl(rawUrl string)(*GithubAppInstallationsRefreshRequestBuilder) { + return NewGithubAppInstallationsRefreshRequestBuilder(rawUrl, m.BaseRequestBuilder.RequestAdapter); +} diff --git a/v2/api/admin/github_app_installations_request_builder.go b/v2/api/admin/github_app_installations_request_builder.go new file mode 100644 index 000000000..f8e3f55f9 --- /dev/null +++ b/v2/api/admin/github_app_installations_request_builder.go @@ -0,0 +1,80 @@ +// Code generated by Microsoft Kiota - DO NOT EDIT. +// Changes may cause incorrect behavior and will be lost if the code is regenerated. + +package admin + +import ( + "context" + i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f "github.com/microsoft/kiota-abstractions-go" + i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16 "github.com/hashicorp/go-tfe/v2/api/models" + i29f064c7e59f3e5a274b550a89f5458f0591299b377f36eee0d0624e5a1f2520 "github.com/hashicorp/go-tfe/v2/api/admin/githubappinstallations" +) + +// GithubAppInstallationsRequestBuilder builds and executes requests for operations under \admin\github-app-installations +type GithubAppInstallationsRequestBuilder struct { + i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.BaseRequestBuilder +} +// GithubAppInstallationsRequestBuilderGetQueryParameters list the webhook-synchronized installations of the site's Global GitHub App across every organization, including disconnected and suspended installations. This endpoint is exclusive to Terraform Enterprise and requires site-admin access.This operation is only available in Terraform Enterprise. +type GithubAppInstallationsRequestBuilderGetQueryParameters struct { + // Filter by GitHub account name (partial match) or exact GitHub installation ID. + Filterquery *string "uriparametername:\"filter%5Bquery%5D\"" + // Filter by installation status. Defaults to all. + Filterstatus *i29f064c7e59f3e5a274b550a89f5458f0591299b377f36eee0d0624e5a1f2520.GetFilterStatusQueryParameterType "uriparametername:\"filter%5Bstatus%5D\"" + // Filter by GitHub account type. + Filtertype *i29f064c7e59f3e5a274b550a89f5458f0591299b377f36eee0d0624e5a1f2520.GetFilterTypeQueryParameterType "uriparametername:\"filter%5Btype%5D\"" + // The page number to retrieve. + Pagenumber *int32 "uriparametername:\"page%5Bnumber%5D\"" + // The number of items to retrieve per page. Defaults to 20. + Pagesize *int32 "uriparametername:\"page%5Bsize%5D\"" +} +// NewGithubAppInstallationsRequestBuilderInternal instantiates a new GithubAppInstallationsRequestBuilder and sets the default values. +func NewGithubAppInstallationsRequestBuilderInternal(pathParameters map[string]string, requestAdapter i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.RequestAdapter)(*GithubAppInstallationsRequestBuilder) { + m := &GithubAppInstallationsRequestBuilder{ + BaseRequestBuilder: *i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.NewBaseRequestBuilder(requestAdapter, "{+baseurl}/admin/github-app-installations{?filter%5Bquery%5D*,filter%5Bstatus%5D*,filter%5Btype%5D*,page%5Bnumber%5D*,page%5Bsize%5D*}", pathParameters), + } + return m +} +// NewGithubAppInstallationsRequestBuilder instantiates a new GithubAppInstallationsRequestBuilder and sets the default values. +func NewGithubAppInstallationsRequestBuilder(rawUrl string, requestAdapter i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.RequestAdapter)(*GithubAppInstallationsRequestBuilder) { + urlParams := make(map[string]string) + urlParams["request-raw-url"] = rawUrl + return NewGithubAppInstallationsRequestBuilderInternal(urlParams, requestAdapter) +} +// Get list the webhook-synchronized installations of the site's Global GitHub App across every organization, including disconnected and suspended installations. This endpoint is exclusive to Terraform Enterprise and requires site-admin access.This operation is only available in Terraform Enterprise. +// returns a GithubAppInstallationsGetResponseable when successful +// returns a Errors error when the service returns a 4XX or 5XX status code +func (m *GithubAppInstallationsRequestBuilder) Get(ctx context.Context, requestConfiguration *i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.RequestConfiguration[GithubAppInstallationsRequestBuilderGetQueryParameters])(GithubAppInstallationsGetResponseable, error) { + requestInfo, err := m.ToGetRequestInformation(ctx, requestConfiguration); + if err != nil { + return nil, err + } + errorMapping := i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.ErrorMappings { + "XXX": i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.CreateErrorsFromDiscriminatorValue, + } + res, err := m.BaseRequestBuilder.RequestAdapter.Send(ctx, requestInfo, CreateGithubAppInstallationsGetResponseFromDiscriminatorValue, errorMapping) + if err != nil { + return nil, err + } + if res == nil { + return nil, nil + } + return res.(GithubAppInstallationsGetResponseable), nil +} +// Refresh the refresh property +// returns a *GithubAppInstallationsRefreshRequestBuilder when successful +func (m *GithubAppInstallationsRequestBuilder) Refresh()(*GithubAppInstallationsRefreshRequestBuilder) { + return NewGithubAppInstallationsRefreshRequestBuilderInternal(m.BaseRequestBuilder.PathParameters, m.BaseRequestBuilder.RequestAdapter) +} +// ToGetRequestInformation list the webhook-synchronized installations of the site's Global GitHub App across every organization, including disconnected and suspended installations. This endpoint is exclusive to Terraform Enterprise and requires site-admin access.This operation is only available in Terraform Enterprise. +// returns a *RequestInformation when successful +func (m *GithubAppInstallationsRequestBuilder) ToGetRequestInformation(ctx context.Context, requestConfiguration *i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.RequestConfiguration[GithubAppInstallationsRequestBuilderGetQueryParameters])(*i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.RequestInformation, error) { + requestInfo := i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.NewRequestInformationWithMethodAndUrlTemplateAndPathParameters(i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.GET, m.BaseRequestBuilder.UrlTemplate, m.BaseRequestBuilder.PathParameters) + i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.ConfigureRequestInformation(requestInfo, requestConfiguration) + requestInfo.Headers.TryAdd("Accept", "application/vnd.api+json") + return requestInfo, nil +} +// WithUrl returns a request builder with the provided arbitrary URL. Using this method means any other path or query parameters are ignored. +// returns a *GithubAppInstallationsRequestBuilder when successful +func (m *GithubAppInstallationsRequestBuilder) WithUrl(rawUrl string)(*GithubAppInstallationsRequestBuilder) { + return NewGithubAppInstallationsRequestBuilder(rawUrl, m.BaseRequestBuilder.RequestAdapter); +} diff --git a/v2/api/admin/githubappinstallations/get_filter_status_query_parameter_type.go b/v2/api/admin/githubappinstallations/get_filter_status_query_parameter_type.go new file mode 100644 index 000000000..5d4a75d11 --- /dev/null +++ b/v2/api/admin/githubappinstallations/get_filter_status_query_parameter_type.go @@ -0,0 +1,42 @@ +// Code generated by Microsoft Kiota - DO NOT EDIT. +// Changes may cause incorrect behavior and will be lost if the code is regenerated. + +package githubappinstallations +type GetFilterStatusQueryParameterType int + +const ( + ALL_GETFILTERSTATUSQUERYPARAMETERTYPE GetFilterStatusQueryParameterType = iota + CONNECTED_GETFILTERSTATUSQUERYPARAMETERTYPE + DISCONNECTED_GETFILTERSTATUSQUERYPARAMETERTYPE + SUSPENDED_GETFILTERSTATUSQUERYPARAMETERTYPE +) + +func (i GetFilterStatusQueryParameterType) String() string { + return []string{"all", "connected", "disconnected", "suspended"}[i] +} +func ParseGetFilterStatusQueryParameterType(v string) (any, error) { + result := ALL_GETFILTERSTATUSQUERYPARAMETERTYPE + switch v { + case "all": + result = ALL_GETFILTERSTATUSQUERYPARAMETERTYPE + case "connected": + result = CONNECTED_GETFILTERSTATUSQUERYPARAMETERTYPE + case "disconnected": + result = DISCONNECTED_GETFILTERSTATUSQUERYPARAMETERTYPE + case "suspended": + result = SUSPENDED_GETFILTERSTATUSQUERYPARAMETERTYPE + default: + return nil, nil + } + return &result, nil +} +func SerializeGetFilterStatusQueryParameterType(values []GetFilterStatusQueryParameterType) []string { + result := make([]string, len(values)) + for i, v := range values { + result[i] = v.String() + } + return result +} +func (i GetFilterStatusQueryParameterType) isMultiValue() bool { + return false +} diff --git a/v2/api/admin/githubappinstallations/get_filter_type_query_parameter_type.go b/v2/api/admin/githubappinstallations/get_filter_type_query_parameter_type.go new file mode 100644 index 000000000..f4bb1f54e --- /dev/null +++ b/v2/api/admin/githubappinstallations/get_filter_type_query_parameter_type.go @@ -0,0 +1,36 @@ +// Code generated by Microsoft Kiota - DO NOT EDIT. +// Changes may cause incorrect behavior and will be lost if the code is regenerated. + +package githubappinstallations +type GetFilterTypeQueryParameterType int + +const ( + ORGANIZATION_GETFILTERTYPEQUERYPARAMETERTYPE GetFilterTypeQueryParameterType = iota + USER_GETFILTERTYPEQUERYPARAMETERTYPE +) + +func (i GetFilterTypeQueryParameterType) String() string { + return []string{"Organization", "User"}[i] +} +func ParseGetFilterTypeQueryParameterType(v string) (any, error) { + result := ORGANIZATION_GETFILTERTYPEQUERYPARAMETERTYPE + switch v { + case "Organization": + result = ORGANIZATION_GETFILTERTYPEQUERYPARAMETERTYPE + case "User": + result = USER_GETFILTERTYPEQUERYPARAMETERTYPE + default: + return nil, nil + } + return &result, nil +} +func SerializeGetFilterTypeQueryParameterType(values []GetFilterTypeQueryParameterType) []string { + result := make([]string, len(values)) + for i, v := range values { + result[i] = v.String() + } + return result +} +func (i GetFilterTypeQueryParameterType) isMultiValue() bool { + return false +} diff --git a/v2/api/kiota-lock.json b/v2/api/kiota-lock.json index 6e13518cf..3bb0decd3 100644 --- a/v2/api/kiota-lock.json +++ b/v2/api/kiota-lock.json @@ -1,5 +1,5 @@ { - "descriptionHash": "DB80292A0403F7EABAB9708254806BDAEADBBB42CB4B305E98D090799A6ADB93AAF9FA7366B0455A7C1544AB059BA6F3DEBA0BDF39FB5D97E8780DDA26B28918", + "descriptionHash": "C4011560A84D7E5940D377663AAEC698B31AEB4D46F965C1920445D51CFAD9D63CC646DF8B5E3D6637B6206505E623DD43B763780D7FE9CD68EF0B3E813DF0F8", "descriptionLocation": "../openapi/spec.json", "lockFileVersion": "1.0.0", "kiotaVersion": "1.31.1", diff --git a/v2/api/models/github_app_installations_escaped_attributes.go b/v2/api/models/github_app_installations_escaped_attributes.go index 2ac0a5e16..4526ee2b5 100644 --- a/v2/api/models/github_app_installations_escaped_attributes.go +++ b/v2/api/models/github_app_installations_escaped_attributes.go @@ -10,6 +10,8 @@ import ( type GithubAppInstallations_attributes struct { // Stores additional data not described in the OpenAPI description found when deserializing. Can be used for serialization as well. additionalData map[string]any + // True when GitHub no longer reports this installation. + disconnected *bool // The iconUrl property iconUrl *string // The installationId property @@ -20,6 +22,8 @@ type GithubAppInstallations_attributes struct { installationUrl *string // The name property name *string + // True when the installation is suspended on GitHub. + suspended *bool } // NewGithubAppInstallations_attributes instantiates a new GithubAppInstallations_attributes and sets the default values. func NewGithubAppInstallations_attributes()(*GithubAppInstallations_attributes) { @@ -38,10 +42,25 @@ func CreateGithubAppInstallations_attributesFromDiscriminatorValue(parseNode i87 func (m *GithubAppInstallations_attributes) GetAdditionalData()(map[string]any) { return m.additionalData } +// GetDisconnected gets the disconnected property value. True when GitHub no longer reports this installation. +// returns a *bool when successful +func (m *GithubAppInstallations_attributes) GetDisconnected()(*bool) { + return m.disconnected +} // GetFieldDeserializers the deserialization information for the current model // returns a map[string]func(i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode)(error) when successful func (m *GithubAppInstallations_attributes) GetFieldDeserializers()(map[string]func(i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode)(error)) { res := make(map[string]func(i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode)(error)) + res["disconnected"] = func (n i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode) error { + val, err := n.GetBoolValue() + if err != nil { + return err + } + if val != nil { + m.SetDisconnected(val) + } + return nil + } res["icon-url"] = func (n i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode) error { val, err := n.GetStringValue() if err != nil { @@ -92,6 +111,16 @@ func (m *GithubAppInstallations_attributes) GetFieldDeserializers()(map[string]f } return nil } + res["suspended"] = func (n i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode) error { + val, err := n.GetBoolValue() + if err != nil { + return err + } + if val != nil { + m.SetSuspended(val) + } + return nil + } return res } // GetIconUrl gets the icon-url property value. The iconUrl property @@ -119,8 +148,19 @@ func (m *GithubAppInstallations_attributes) GetInstallationUrl()(*string) { func (m *GithubAppInstallations_attributes) GetName()(*string) { return m.name } +// GetSuspended gets the suspended property value. True when the installation is suspended on GitHub. +// returns a *bool when successful +func (m *GithubAppInstallations_attributes) GetSuspended()(*bool) { + return m.suspended +} // Serialize serializes information the current object func (m *GithubAppInstallations_attributes) Serialize(writer i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.SerializationWriter)(error) { + { + err := writer.WriteBoolValue("disconnected", m.GetDisconnected()) + if err != nil { + return err + } + } { err := writer.WriteStringValue("icon-url", m.GetIconUrl()) if err != nil { @@ -151,6 +191,12 @@ func (m *GithubAppInstallations_attributes) Serialize(writer i878a80d2330e89d268 return err } } + { + err := writer.WriteBoolValue("suspended", m.GetSuspended()) + if err != nil { + return err + } + } { err := writer.WriteAdditionalData(m.GetAdditionalData()) if err != nil { @@ -163,6 +209,10 @@ func (m *GithubAppInstallations_attributes) Serialize(writer i878a80d2330e89d268 func (m *GithubAppInstallations_attributes) SetAdditionalData(value map[string]any)() { m.additionalData = value } +// SetDisconnected sets the disconnected property value. True when GitHub no longer reports this installation. +func (m *GithubAppInstallations_attributes) SetDisconnected(value *bool)() { + m.disconnected = value +} // SetIconUrl sets the icon-url property value. The iconUrl property func (m *GithubAppInstallations_attributes) SetIconUrl(value *string)() { m.iconUrl = value @@ -183,17 +233,25 @@ func (m *GithubAppInstallations_attributes) SetInstallationUrl(value *string)() func (m *GithubAppInstallations_attributes) SetName(value *string)() { m.name = value } +// SetSuspended sets the suspended property value. True when the installation is suspended on GitHub. +func (m *GithubAppInstallations_attributes) SetSuspended(value *bool)() { + m.suspended = value +} type GithubAppInstallations_attributesable interface { i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.AdditionalDataHolder i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.Parsable + GetDisconnected()(*bool) GetIconUrl()(*string) GetInstallationId()(*int32) GetInstallationType()(*string) GetInstallationUrl()(*string) GetName()(*string) + GetSuspended()(*bool) + SetDisconnected(value *bool)() SetIconUrl(value *string)() SetInstallationId(value *int32)() SetInstallationType(value *string)() SetInstallationUrl(value *string)() SetName(value *string)() + SetSuspended(value *bool)() } diff --git a/v2/api/models/policy_sets_envelope.go b/v2/api/models/policy_sets_envelope.go index 3ec6a21c8..2a06c83ab 100644 --- a/v2/api/models/policy_sets_envelope.go +++ b/v2/api/models/policy_sets_envelope.go @@ -12,7 +12,7 @@ type PolicySetsEnvelope struct { additionalData map[string]any // The data property data PolicySetsable - // Sideloaded resources. `?include=policies` sideloads the full policy resources, including OOTB-origin ones. It does NOT sideload their `ootb-policies` catalog resources (control source, catalog metadata, download identity) — request `?include=policies.ootb-policy` for those. + // Sideloaded resources. `?include=policies` sideloads the full policy resources. included []PolicySetsEnvelope_includedable } // NewPolicySetsEnvelope instantiates a new PolicySetsEnvelope and sets the default values. @@ -69,7 +69,7 @@ func (m *PolicySetsEnvelope) GetFieldDeserializers()(map[string]func(i878a80d233 } return res } -// GetIncluded gets the included property value. Sideloaded resources. `?include=policies` sideloads the full policy resources, including OOTB-origin ones. It does NOT sideload their `ootb-policies` catalog resources (control source, catalog metadata, download identity) — request `?include=policies.ootb-policy` for those. +// GetIncluded gets the included property value. Sideloaded resources. `?include=policies` sideloads the full policy resources. // returns a []PolicySetsEnvelope_includedable when successful func (m *PolicySetsEnvelope) GetIncluded()([]PolicySetsEnvelope_includedable) { return m.included @@ -110,7 +110,7 @@ func (m *PolicySetsEnvelope) SetAdditionalData(value map[string]any)() { func (m *PolicySetsEnvelope) SetData(value PolicySetsable)() { m.data = value } -// SetIncluded sets the included property value. Sideloaded resources. `?include=policies` sideloads the full policy resources, including OOTB-origin ones. It does NOT sideload their `ootb-policies` catalog resources (control source, catalog metadata, download identity) — request `?include=policies.ootb-policy` for those. +// SetIncluded sets the included property value. Sideloaded resources. `?include=policies` sideloads the full policy resources. func (m *PolicySetsEnvelope) SetIncluded(value []PolicySetsEnvelope_includedable)() { m.included = value } diff --git a/v2/api/models/policy_sets_envelope_escaped_included.go b/v2/api/models/policy_sets_envelope_escaped_included.go index c82d73499..f993639e9 100644 --- a/v2/api/models/policy_sets_envelope_escaped_included.go +++ b/v2/api/models/policy_sets_envelope_escaped_included.go @@ -7,7 +7,7 @@ import ( i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91 "github.com/microsoft/kiota-abstractions-go/serialization" ) -// PolicySetsEnvelope_included a sideloaded resource. May be a `policies` resource (type "policies"), an `ootb-policies` resource (type "ootb-policies"), a `workspaces` resource (type "workspaces"), or another allowlisted type. +// PolicySetsEnvelope_included a sideloaded resource. May be a `policies` resource (type "policies"), a `workspaces` resource (type "workspaces"), or another allowlisted type. type PolicySetsEnvelope_included struct { // Stores additional data not described in the OpenAPI description found when deserializing. Can be used for serialization as well. additionalData map[string]any diff --git a/v2/api/models/scim_identities_escaped_attributes.go b/v2/api/models/scim_identities_escaped_attributes.go index c5b5a9771..4085851ea 100644 --- a/v2/api/models/scim_identities_escaped_attributes.go +++ b/v2/api/models/scim_identities_escaped_attributes.go @@ -12,6 +12,8 @@ type ScimIdentities_attributes struct { additionalData map[string]any // The provisioning status of the user.- "provisioned": User was created via SCIM provisioning- "claimed": User claimed their account or existed before SCIM status *ScimIdentities_attributes_status + // The username/identity string from the SCIM provider. + username *string } // NewScimIdentities_attributes instantiates a new ScimIdentities_attributes and sets the default values. func NewScimIdentities_attributes()(*ScimIdentities_attributes) { @@ -44,6 +46,16 @@ func (m *ScimIdentities_attributes) GetFieldDeserializers()(map[string]func(i878 } return nil } + res["username"] = func (n i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.ParseNode) error { + val, err := n.GetStringValue() + if err != nil { + return err + } + if val != nil { + m.SetUsername(val) + } + return nil + } return res } // GetStatus gets the status property value. The provisioning status of the user.- "provisioned": User was created via SCIM provisioning- "claimed": User claimed their account or existed before SCIM @@ -51,6 +63,11 @@ func (m *ScimIdentities_attributes) GetFieldDeserializers()(map[string]func(i878 func (m *ScimIdentities_attributes) GetStatus()(*ScimIdentities_attributes_status) { return m.status } +// GetUsername gets the username property value. The username/identity string from the SCIM provider. +// returns a *string when successful +func (m *ScimIdentities_attributes) GetUsername()(*string) { + return m.username +} // Serialize serializes information the current object func (m *ScimIdentities_attributes) Serialize(writer i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.SerializationWriter)(error) { { @@ -69,9 +86,15 @@ func (m *ScimIdentities_attributes) SetAdditionalData(value map[string]any)() { func (m *ScimIdentities_attributes) SetStatus(value *ScimIdentities_attributes_status)() { m.status = value } +// SetUsername sets the username property value. The username/identity string from the SCIM provider. +func (m *ScimIdentities_attributes) SetUsername(value *string)() { + m.username = value +} type ScimIdentities_attributesable interface { i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.AdditionalDataHolder i878a80d2330e89d26896388a3f487eef27b0a0e6c010c493bf80be1452208f91.Parsable GetStatus()(*ScimIdentities_attributes_status) + GetUsername()(*string) SetStatus(value *ScimIdentities_attributes_status)() + SetUsername(value *string)() } diff --git a/v2/api/policysets/item_relationships_policies_request_builder.go b/v2/api/policysets/item_relationships_policies_request_builder.go index 1620f00da..43f1c298c 100644 --- a/v2/api/policysets/item_relationships_policies_request_builder.go +++ b/v2/api/policysets/item_relationships_policies_request_builder.go @@ -42,7 +42,7 @@ func (m *ItemRelationshipsPoliciesRequestBuilder) Delete(ctx context.Context, bo } return nil } -// Post add policies to a policy set. Additive; existing memberships are preserved. Each `data` item is either an existing policy reference (by id) or an inline OOTB selection that materializes a catalog policy into the set -- see the request schema for both shapes. A policy set cannot mix custom and OOTB policies. +// Post add policies to a policy set. Additive; existing memberships are preserved. Each `data` item references an existing policy by id; see the request schema for accepted shapes. // returns a Errors error when the service returns a 4XX or 5XX status code func (m *ItemRelationshipsPoliciesRequestBuilder) Post(ctx context.Context, body i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.PoliciesIdentifierArrayDocumentable, requestConfiguration *i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.RequestConfiguration[i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.DefaultQueryParameters])(error) { requestInfo, err := m.ToPostRequestInformation(ctx, body, requestConfiguration); @@ -70,7 +70,7 @@ func (m *ItemRelationshipsPoliciesRequestBuilder) ToDeleteRequestInformation(ctx } return requestInfo, nil } -// ToPostRequestInformation add policies to a policy set. Additive; existing memberships are preserved. Each `data` item is either an existing policy reference (by id) or an inline OOTB selection that materializes a catalog policy into the set -- see the request schema for both shapes. A policy set cannot mix custom and OOTB policies. +// ToPostRequestInformation add policies to a policy set. Additive; existing memberships are preserved. Each `data` item references an existing policy by id; see the request schema for accepted shapes. // returns a *RequestInformation when successful func (m *ItemRelationshipsPoliciesRequestBuilder) ToPostRequestInformation(ctx context.Context, body i05d5aa6b14db285c2e8df48c915f7a7082b77b17cca0def522e18528f80bec16.PoliciesIdentifierArrayDocumentable, requestConfiguration *i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.RequestConfiguration[i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.DefaultQueryParameters])(*i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.RequestInformation, error) { requestInfo := i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.NewRequestInformationWithMethodAndUrlTemplateAndPathParameters(i2ae4187f7daee263371cb1c977df639813ab50ffa529013b7437480d1ec0158f.POST, m.BaseRequestBuilder.UrlTemplate, m.BaseRequestBuilder.PathParameters) diff --git a/v2/openapi/spec.json b/v2/openapi/spec.json index 4356220d3..221a39d41 100644 --- a/v2/openapi/spec.json +++ b/v2/openapi/spec.json @@ -1,7 +1,7 @@ { "openapi": "3.0.0", "info": { - "version": "956901b5", + "version": "63ddfcc6", "title": "HCP Terraform/Terraform Enterprise API v2-Beta", "description": "OpenAPI Specification for the HCP Terraform/Terraform Enterprise API V2 Public Beta.", "license": { @@ -13587,7 +13587,7 @@ "post": { "operationId": "addPolicySetPolicies", "summary": "Add Policies to a Policy Set", - "description": "Add policies to a policy set. Additive; existing memberships are preserved. Each `data` item is either an existing policy reference (by id) or an inline OOTB selection that materializes a catalog policy into the set -- see the request schema for both shapes. A policy set cannot mix custom and OOTB policies.", + "description": "Add policies to a policy set. Additive; existing memberships are preserved. Each `data` item references an existing policy by id; see the request schema for accepted shapes.", "tags": [ "policy-sets" ], @@ -22052,6 +22052,135 @@ } } }, + "/admin/github-app-installations": { + "x-vis": [ + "tfe" + ], + "get": { + "operationId": "adminListGithubAppInstallations", + "summary": "List GitHub App Installations (Admin)", + "description": "List the webhook-synchronized installations of the site's Global GitHub App across every organization, including disconnected and suspended installations. This endpoint is exclusive to Terraform Enterprise and requires site-admin access.\n\nThis operation is only available in Terraform Enterprise.", + "tags": [ + "github-app-installations" + ], + "parameters": [ + { + "in": "query", + "name": "filter[query]", + "schema": { + "type": "string", + "maxLength": 255 + }, + "required": false, + "description": "Filter by GitHub account name (partial match) or exact GitHub installation ID." + }, + { + "in": "query", + "name": "filter[status]", + "schema": { + "type": "string", + "enum": [ + "all", + "connected", + "disconnected", + "suspended" + ] + }, + "required": false, + "description": "Filter by installation status. Defaults to all." + }, + { + "in": "query", + "name": "filter[type]", + "schema": { + "type": "string", + "enum": [ + "Organization", + "User" + ] + }, + "required": false, + "description": "Filter by GitHub account type." + }, + { + "$ref": "#/components/parameters/page_number" + }, + { + "$ref": "#/components/parameters/page_size" + } + ], + "responses": { + "200": { + "description": "List of GitHub App installations", + "content": { + "application/vnd.api+json": { + "schema": { + "type": "object", + "properties": { + "data": { + "type": "array", + "items": { + "$ref": "#/components/schemas/github-app-installations" + } + }, + "meta": { + "type": "object", + "properties": { + "pagination": { + "$ref": "#/components/schemas/pagination" + }, + "total-installation-count": { + "type": "integer", + "description": "The unfiltered number of synchronized installations for the app, independent of the filter and page parameters." + } + } + } + } + } + } + } + }, + "default": { + "description": "Error details", + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/errors" + } + } + } + } + } + } + }, + "/admin/github-app-installations/refresh": { + "x-vis": [ + "tfe" + ], + "post": { + "operationId": "adminRefreshGithubAppInstallations", + "summary": "Refresh GitHub App Installations (Admin)", + "description": "Request an on-demand reconciliation of the Global GitHub App's installation inventory against GitHub, recovering installations whose webhook deliveries were missed. Only available when the app is hosted on GHE.com. This endpoint is exclusive to Terraform Enterprise and requires site-admin access.\n\nThis operation is only available in Terraform Enterprise.", + "tags": [ + "github-app-installations" + ], + "responses": { + "204": { + "description": "Reconciliation enqueued" + }, + "default": { + "description": "Error details", + "content": { + "application/vnd.api+json": { + "schema": { + "$ref": "#/components/schemas/errors" + } + } + } + } + } + } + }, "/organizations/{organization_name}/github-app-installations": { "get": { "operationId": "listOrganizationGithubAppInstallations", @@ -26420,6 +26549,11 @@ ], "readOnly": true, "description": "The provisioning status of the user.\n- \"provisioned\": User was created via SCIM provisioning\n- \"claimed\": User claimed their account or existed before SCIM\n" + }, + "username": { + "type": "string", + "readOnly": true, + "description": "The username/identity string from the SCIM provider." } } } @@ -32096,10 +32230,10 @@ }, "included": { "type": "array", - "description": "Sideloaded resources. `?include=policies` sideloads the full policy resources, including OOTB-origin ones. It does NOT sideload their `ootb-policies` catalog resources (control source, catalog metadata, download identity) — request `?include=policies.ootb-policy` for those.", + "description": "Sideloaded resources. `?include=policies` sideloads the full policy resources.", "items": { "type": "object", - "description": "A sideloaded resource. May be a `policies` resource (type \"policies\"), an `ootb-policies` resource (type \"ootb-policies\"), a `workspaces` resource (type \"workspaces\"), or another allowlisted type." + "description": "A sideloaded resource. May be a `policies` resource (type \"policies\"), a `workspaces` resource (type \"workspaces\"), or another allowlisted type." } } } @@ -35287,6 +35421,14 @@ "installation-url": { "type": "string", "nullable": true + }, + "disconnected": { + "type": "boolean", + "description": "True when GitHub no longer reports this installation." + }, + "suspended": { + "type": "boolean", + "description": "True when the installation is suspended on GitHub." } } }