Add alert source APIs (#543)

* Add default value to documentation on fields based on schema

* Add alert source APIs

Author: rocktavious

.changes/unreleased/Feature-20250514-144247.yaml

@@ -0,0 +1,3 @@
+kind: Feature
+body: Add `client.CreateOrUpdateAlertSource` and `client.UpdateAlertSourceStatus` to interface with the new generic alert source APIs
+time: 2025-05-14T14:42:47.635522-05:00

alert_source.go

@@ -12,6 +12,20 @@ func NewAlertSource(kind AlertSourceTypeEnum, id string) *AlertSourceExternalIde
 	return &output
 }
 
+func (client *Client) CreateOrUpdateAlertSource(input AlertSourceInput) (*AlertSource, error) {
+	var m struct {
+		Payload struct {
+			AlertSource AlertSource
+			Errors      []Error
+		} `graphql:"alertSourceUpsert(input: $input)"`
+	}
+	v := PayloadVariables{
+		"input": input,
+	}
+	err := client.Mutate(&m, v, WithName("AlertSourceUpsert"))
+	return &m.Payload.AlertSource, HandleErrors(err, m.Payload.Errors)
+}
+
 func (client *Client) CreateAlertSourceService(input AlertSourceServiceCreateInput) (*AlertSourceService, error) {
 	var m struct {
 		Payload AlertSourceServiceCreatePayload `graphql:"alertSourceServiceCreate(input: $input)"`
@@ -51,6 +65,20 @@ func (client *Client) GetAlertSource(id ID) (*AlertSource, error) {
 	return &q.Account.AlertSource, HandleErrors(err, nil)
 }
 
+func (client *Client) UpdateAlertSourceStatus(input AlertSourceStatusUpdateInput) (*AlertSource, error) {
+	var m struct {
+		Payload struct {
+			AlertSource AlertSource
+			Errors      []Error
+		} `graphql:"alertSourceStatusUpdate(input: $input)"`
+	}
+	v := PayloadVariables{
+		"input": input,
+	}
+	err := client.Mutate(&m, v, WithName("AlertSourceStatusUpdate"))
+	return &m.Payload.AlertSource, HandleErrors(err, m.Payload.Errors)
+}
+
 func (client *Client) DeleteAlertSourceService(id ID) error {
 	var m struct {
 		Payload BasePayload `graphql:"alertSourceServiceDelete(input: $input)"`

input.go

@@ -6,7 +6,15 @@ import "github.com/relvacode/iso8601"
 // AlertSourceExternalIdentifier Specifies the input needed to find an alert source with external information
 type AlertSourceExternalIdentifier struct {
 	ExternalId string              `json:"externalId" yaml:"externalId" example:"Z2lkOi8vc2VydmljZS8xMjM0NTY3ODk"` // The external id of the alert (Required)
-	Type       AlertSourceTypeEnum `json:"type" yaml:"type" example:"datadog"`                                     // The type of the alert (Required)
+	Type       AlertSourceTypeEnum `json:"type" yaml:"type" example:"custom"`                                      // The type of the alert (Required)
+}
+
+// AlertSourceInput Input fields for the mutations to manage Alert Sources
+type AlertSourceInput struct {
+	Description *Nullable[string]               `json:"description,omitempty" yaml:"description,omitempty" example:"example_value"` // The description of the alert source (Optional)
+	Identifier  ExternalResourceIdentifierInput `json:"identifier" yaml:"identifier"`                                               // The alert source identifier (Required)
+	Name        *Nullable[string]               `json:"name,omitempty" yaml:"name,omitempty" example:"example_value"`               // The name of the alert source (Optional)
+	Url         *Nullable[string]               `json:"url,omitempty" yaml:"url,omitempty" example:"example_value"`                 // The url of the alert source (Optional)
 }
 
 // AlertSourceServiceCreateInput Specifies the input used for attaching an alert source to a service
@@ -21,6 +29,12 @@ type AlertSourceServiceDeleteInput struct {
 	Id ID `json:"id" yaml:"id" example:"Z2lkOi8vc2VydmljZS8xMjM0NTY3ODk"` // The id of the alert source service to be deleted (Required)
 }
 
+// AlertSourceStatusUpdateInput Specifies the input fields used in the `alertSourceStatusUpdate` mutation
+type AlertSourceStatusUpdateInput struct {
+	AlertSource ExternalResourceIdentifierInput `json:"alertSource" yaml:"alertSource"`       // The alert source to be updated (Required)
+	Status      AlertSourceStatusTypeEnum       `json:"status" yaml:"status" example:"alert"` // The new status of the alert source (Required)
+}
+
 // AliasCreateInput The input for the `aliasCreate` mutation
 type AliasCreateInput struct {
 	Alias   string `json:"alias" yaml:"alias" example:"example_value"`     // The alias you wish to create (Required)
@@ -792,6 +806,12 @@ type EventIntegrationUpdateInput struct {
 	Name string `json:"name" yaml:"name" example:"example_value"`               // The name of the event integration (Required)
 }
 
+// ExternalResourceIdentifierInput Specifies the input fields to locate resouce created via API in OpsLevel
+type ExternalResourceIdentifierInput struct {
+	ExternalId  string          `json:"externalId" yaml:"externalId" example:"Z2lkOi8vc2VydmljZS8xMjM0NTY3ODk"` // The id of the resource in your system (Required)
+	Integration IdentifierInput `json:"integration" yaml:"integration"`                                         // The integration identifier (Required)
+}
+
 // ExternalUuidMutationInput Specifies the input used for modifying a resource's external UUID
 type ExternalUuidMutationInput struct {
 	ResourceId ID `json:"resourceId" yaml:"resourceId" example:"Z2lkOi8vc2VydmljZS8xMjM0NTY3ODk"` // The id of the resource (Required)