fleetapi

type Client struct {
	// The endpoint of the server conforming to this interface, with scheme,
	// https://api.deepmap.com for example. This can contain a path relative
	// to the server, such as https://api.deepmap.com/dev-test, and all the
	// paths in the swagger spec will be appended to the server.
	Server string

	// Doer for performing requests, typically a *http.Client with any
	// customized settings, such as certificate chains.
	Client HttpRequestDoer

	// A list of callbacks for modifying requests which are generated before sending over
	// the network.
	RequestEditors []RequestEditorFn
}

type ClientInterface interface {

	// GetWellKnownSigningKeyPub Get inventory-report public verification key
	//
	// Returns NVIDIA's currently-active public key for verifying signed inventory reports. Use with `cosign verify-blob --key signing-key.pub --bundle <file>.sig.bundle <file>.csv`. The key is PEM-encoded (PKIX SubjectPublicKeyInfo). After a key rotation this URL serves the new key; reports signed under previous keys cease to verify and customers must re-download.
	//
	// Corresponds with GET /.well-known/signing-key.pub (the `GetWellKnownSigningKeyPub` operationId).
	GetWellKnownSigningKeyPub(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// DeleteV1AlertMuteRulesWithBody Delete mute rules
	//
	// Delete mute rules for a specific component, or delete all mute rules for the customer.
	// With body: provide component (required) and optionally severities. If severities is empty, deletes all rules for the component.
	// Without body: deletes ALL mute rules for the customer.
	//
	// Takes any type of body and a specified content type.
	//
	// Corresponds with DELETE /v1/alert_mute_rules (the `DeleteV1AlertMuteRules` operationId).
	DeleteV1AlertMuteRulesWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	// DeleteV1AlertMuteRules Delete mute rules
	//
	// Delete mute rules for a specific component, or delete all mute rules for the customer.
	// With body: provide component (required) and optionally severities. If severities is empty, deletes all rules for the component.
	// Without body: deletes ALL mute rules for the customer.
	//
	// Takes a body of the `application/json` content type.
	//
	// Corresponds with DELETE /v1/alert_mute_rules (the `DeleteV1AlertMuteRules` operationId).
	DeleteV1AlertMuteRules(ctx context.Context, body DeleteV1AlertMuteRulesJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1AlertMuteRules List mute rules
	//
	// Get all customer-wide mute rules grouped by component. Each component shows which severities (Critical, Warning) are muted.
	//
	// Corresponds with GET /v1/alert_mute_rules (the `GetV1AlertMuteRules` operationId).
	GetV1AlertMuteRules(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PutV1AlertMuteRulesWithBody Update mute rule for a component
	//
	// Declarative per-component update: set this component to exactly the specified severities.
	// If severities is empty or omitted, defaults to both Critical and Warning.
	// This replaces any existing mute configuration for the component.
	// Returns 204 No Content on success. Use GET /v1/alert_mute_rules to retrieve current state.
	//
	// Takes any type of body and a specified content type.
	//
	// Corresponds with PUT /v1/alert_mute_rules (the `PutV1AlertMuteRules` operationId).
	PutV1AlertMuteRulesWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PutV1AlertMuteRules Update mute rule for a component
	//
	// Declarative per-component update: set this component to exactly the specified severities.
	// If severities is empty or omitted, defaults to both Critical and Warning.
	// This replaces any existing mute configuration for the component.
	// Returns 204 No Content on success. Use GET /v1/alert_mute_rules to retrieve current state.
	//
	// Takes a body of the `application/json` content type.
	//
	// Corresponds with PUT /v1/alert_mute_rules (the `PutV1AlertMuteRules` operationId).
	PutV1AlertMuteRules(ctx context.Context, body PutV1AlertMuteRulesJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1AlertTimelineFilterOptions Get filter dropdown options for the alert panel
	//
	// Get the set of filter values (GPU types, node groups, compute zones, component types, alert states) available for the alert panel, returned in the shared options envelope (filters.fields[] + sorting) used by the node and node-group options endpoints. Every value is scoped to the customer's alerts in the chosen view, so each option is guaranteed to return results when applied as a filter. Use the 'active' parameter to switch between the Active and Historical views; the historical view may additionally surface the Resolved alert state. Object-valued options ({id, value}) carry the filter id and its display value (node group / compute zone ids and names; component identifier and display name); gpuTypes and alertStates are plain strings. The sorting block advertises the Level 1 nodes-list sort columns. componentVisibility is resolved server-side from the caller's persona.
	//
	// Corresponds with GET /v1/alert_timeline/filter_options (the `GetV1AlertTimelineFilterOptions` operationId).
	GetV1AlertTimelineFilterOptions(ctx context.Context, params *GetV1AlertTimelineFilterOptionsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1AlertTimelineNodes List impacted machines with alert summary (level 1)
	//
	// Returns a paginated list of nodes with per-node alert counts and inventory metadata for the Alerts panel. Use active=true for the Active Alerts view (only nodes with currently active alerts) or active=false for Historical Alerts. Cross-page aggregates (totalCritical, totalWarning, distinctGpuTypeCount, etc.) reflect the full filtered result set and drive table header counts. componentVisibility is resolved server-side from the user's auth persona and is not an HTTP parameter.
	//
	// Corresponds with GET /v1/alert_timeline/nodes (the `GetV1AlertTimelineNodes` operationId).
	GetV1AlertTimelineNodes(ctx context.Context, params *GetV1AlertTimelineNodesParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1AlertTimelineNodesNodeUuidAlerts Get alerts for a specific node (level 2)
	//
	// Get list of alerts for a specific node. Returns alert UUID, component, alert status, start time, and last event time. Use the 'active' parameter to switch between active and historical views. The sortable table-header columns and the filter dimensions mirror the Level 1 nodes list, so the panel can forward the same filter set unchanged.
	//
	// Corresponds with GET /v1/alert_timeline/nodes/{nodeUUID}/alerts (the `GetV1AlertTimelineNodesNodeUuidAlerts` operationId).
	GetV1AlertTimelineNodesNodeUuidAlerts(ctx context.Context, nodeUUID string, params *GetV1AlertTimelineNodesNodeUuidAlertsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1AlertTimelineNodesNodeUuidAlertsAlertUuid Get complete timeline for a specific alert (level 3)
	//
	// Get complete timeline for a specific alert. Returns alert UUID, component, current alertStatus, nodeGroup, computeZone, and complete event timeline. This is the third level of the progressive disclosure API for alert timelines. Events default to newest-first (most recent update first); pass order=asc for chronological (oldest-first) order. Pagination of the timeline events is optional and backward compatible: omit pageSize to receive the full timeline (default); supply pageSize to page through the events, in which case the response also carries page/pageSize/total/hasMore metadata.
	//
	// Corresponds with GET /v1/alert_timeline/nodes/{nodeUUID}/alerts/{alertUUID} (the `GetV1AlertTimelineNodesNodeUuidAlertsAlertUuid` operationId).
	GetV1AlertTimelineNodesNodeUuidAlertsAlertUuid(ctx context.Context, nodeUUID string, alertUUID string, params *GetV1AlertTimelineNodesNodeUuidAlertsAlertUuidParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1Alerts Get alerts
	//
	// Get list of alerts with optional filtering by node, component, state, and severity
	//
	// Corresponds with GET /v1/alerts (the `GetV1Alerts` operationId).
	GetV1Alerts(ctx context.Context, params *GetV1AlertsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1AlertsNodeUuid Get alerts for a specific node
	//
	// Get list of alerts for a specific node (machine) identified by nodeUUID, grouped by component
	//
	// Corresponds with GET /v1/alerts/{nodeUUID} (the `GetV1AlertsNodeUuid` operationId).
	GetV1AlertsNodeUuid(ctx context.Context, nodeUUID string, params *GetV1AlertsNodeUuidParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1AuthStatus Get authentication status
	//
	// Returns whether the request reached the backend through the authenticated KAS path.
	//
	// Corresponds with GET /v1/auth/status (the `GetV1AuthStatus` operationId).
	GetV1AuthStatus(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1Computezones Get compute zones
	//
	// Get list of compute zones with optional filtering and different view modes. Use view=detail for comprehensive metrics and view=basic for essential fields (ID, Name, Type, GeoLocation, Contact, timestamps)
	//
	// Corresponds with GET /v1/computezones (the `GetV1Computezones` operationId).
	GetV1Computezones(ctx context.Context, params *GetV1ComputezonesParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PutV1ComputezonesWithBody Update compute zone
	//
	// Admin updates compute zone type and metadata. Compute zone names are agent-managed and cannot be changed from customer-api.
	//
	// Takes any type of body and a specified content type.
	//
	// Corresponds with PUT /v1/computezones (the `PutV1Computezones` operationId).
	PutV1ComputezonesWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PutV1Computezones Update compute zone
	//
	// Admin updates compute zone type and metadata. Compute zone names are agent-managed and cannot be changed from customer-api.
	//
	// Takes a body of the `application/json` content type.
	//
	// Corresponds with PUT /v1/computezones (the `PutV1Computezones` operationId).
	PutV1Computezones(ctx context.Context, body PutV1ComputezonesJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1Events Get events
	//
	// Get list of events with optional filtering by node UUID, component, and time range. Returns events from the events table for the specified time period.
	//
	// Corresponds with GET /v1/events (the `GetV1Events` operationId).
	GetV1Events(ctx context.Context, params *GetV1EventsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1EventsBuckets Get event counts bucketed by time
	//
	// Returns time-bucketed event counts for histogram display. The server picks a clean bucket interval based on the maxBuckets hint.
	//
	// Corresponds with GET /v1/events/buckets (the `GetV1EventsBuckets` operationId).
	GetV1EventsBuckets(ctx context.Context, params *GetV1EventsBucketsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1Info Get application info
	//
	// Get version and build information for API backend and agent backend components, plus the current inventory-report signing key's rotation freshness.
	//
	// Corresponds with GET /v1/info (the `GetV1Info` operationId).
	GetV1Info(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1Metrics Get available metrics
	//
	// Get a list of all available metrics, organized by component. Supports optional filtering by isCritical, aggregatable, and type. Unknown or false values for boolean params are treated as no filter.
	// Use psirtComponent=true to include active PSIRT CVE sub-components under the "psirt" component.
	//
	// Corresponds with GET /v1/metrics (the `GetV1Metrics` operationId).
	GetV1Metrics(ctx context.Context, params *GetV1MetricsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1MetricsQueryRange Query metric range
	//
	// Query data for a particular metric for a node, node group, or compute zone over a range of time
	//
	// Corresponds with GET /v1/metrics/query_range (the `GetV1MetricsQueryRange` operationId).
	GetV1MetricsQueryRange(ctx context.Context, params *GetV1MetricsQueryRangeParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1NodeGroupMemberships Get node group memberships
	//
	// Get list of node group memberships with optional filtering. Customer ID is automatically extracted from the NV-ngc-nca-id header and used for filtering.
	//
	// Corresponds with GET /v1/node_group_memberships (the `GetV1NodeGroupMemberships` operationId).
	GetV1NodeGroupMemberships(ctx context.Context, params *GetV1NodeGroupMembershipsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1NodeRemovalPolicy Get auto node removal policy
	//
	// Returns the customer's "Auto remove machines" settings. Customers that never
	// configured the policy get the defaults (disabled, offlineThreshold omitted).
	//
	// Corresponds with GET /v1/node_removal_policy (the `GetV1NodeRemovalPolicy` operationId).
	GetV1NodeRemovalPolicy(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PutV1NodeRemovalPolicyWithBody Update auto node removal policy
	//
	// Updates the customer's "Auto remove machines" settings. When offlineThreshold
	// is omitted the stored threshold is kept (disabling never clears it), so it is
	// required only when enabling for the first time. The equivalent duration must be
	// at least 1 day (whole numbers). An omitted enabled binds as false.
	// Returns 204 No Content on success.
	//
	// Takes any type of body and a specified content type.
	//
	// Corresponds with PUT /v1/node_removal_policy (the `PutV1NodeRemovalPolicy` operationId).
	PutV1NodeRemovalPolicyWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PutV1NodeRemovalPolicy Update auto node removal policy
	//
	// Updates the customer's "Auto remove machines" settings. When offlineThreshold
	// is omitted the stored threshold is kept (disabling never clears it), so it is
	// required only when enabling for the first time. The equivalent duration must be
	// at least 1 day (whole numbers). An omitted enabled binds as false.
	// Returns 204 No Content on success.
	//
	// Takes a body of the `application/json` content type.
	//
	// Corresponds with PUT /v1/node_removal_policy (the `PutV1NodeRemovalPolicy` operationId).
	PutV1NodeRemovalPolicy(ctx context.Context, body PutV1NodeRemovalPolicyJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1Nodegroups Get node groups
	//
	// Get list of node groups with optional filtering and different view modes. Use view=detail for comprehensive metrics and view=basic for minimal ID/Name list. Detail view supports additional filters: computeZoneNames (partial match), healthStatuses, and gpuTypes
	//
	// Corresponds with GET /v1/nodegroups (the `GetV1Nodegroups` operationId).
	GetV1Nodegroups(ctx context.Context, params *GetV1NodegroupsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1NodegroupsOptions Get available query options for node groups
	//
	// Returns available filters and sorting options for querying node groups.
	// Filter options may be simple strings (e.g., health statuses, GPU types) or hierarchical objects (e.g., compute zones with nested nodegroups).
	//
	// Filter options examples:
	// - Simple strings: `{"name": "healthStatuses", "options": ["Healthy", "Degraded", "Unhealthy"]}`
	// - Hierarchical objects: `{"name": "computeZones", "options": [{"id": "cz-1", "value": "Zone 1", "options": [{"id": "ng-1", "value": "Node Group 1"}]}]}`
	//
	// Corresponds with GET /v1/nodegroups/options (the `GetV1NodegroupsOptions` operationId).
	GetV1NodegroupsOptions(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// DeleteV1NodesWithBody Delete multiple nodes (soft delete)
	//
	// Soft delete multiple nodes by setting the deleted flag to true.
	//
	// Takes any type of body and a specified content type.
	//
	// Corresponds with DELETE /v1/nodes (the `DeleteV1Nodes` operationId).
	DeleteV1NodesWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	// DeleteV1Nodes Delete multiple nodes (soft delete)
	//
	// Soft delete multiple nodes by setting the deleted flag to true.
	//
	// Takes a body of the `application/json` content type.
	//
	// Corresponds with DELETE /v1/nodes (the `DeleteV1Nodes` operationId).
	DeleteV1Nodes(ctx context.Context, body DeleteV1NodesJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1Nodes Get nodes overview and states
	//
	// Get list of nodes with current state and overview. Use view=detail (default) for full response or view=basic for a lightweight nodeUUID + hostname list (see models.BasicNodesResponse). All filter parameters are optional arrays - empty means no filter applied.
	//
	// Corresponds with GET /v1/nodes (the `GetV1Nodes` operationId).
	GetV1Nodes(ctx context.Context, params *GetV1NodesParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1NodesHistory List node removal history
	//
	// Returns removed machines for the customer, newest first. Covers both
	// auto-removed (actorType system, deleted by the node reaper) and manually
	// deleted (actorType user) nodes. The same machine may appear multiple times
	// across remove/re-enroll cycles.
	//
	// Corresponds with GET /v1/nodes/history (the `GetV1NodesHistory` operationId).
	GetV1NodesHistory(ctx context.Context, params *GetV1NodesHistoryParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1NodesOptions Get available query options for nodes
	//
	// Returns available filters and sorting options for querying nodes.
	// Filter options may be simple strings (e.g., health statuses) or hierarchical objects (e.g., compute zones with nested nodegroups).
	//
	// Filter options examples:
	// - Simple strings: `{"name": "healthStatuses", "options": ["Healthy", "Degraded", "Unhealthy"]}`
	// - Hierarchical objects: `{"name": "computeZones", "options": [{"id": "cz-1", "value": "Zone 1", "options": [{"id": "ng-1", "value": "Node Group 1"}]}]}`
	//
	// The available options depend on the agentType view. The OOB view omits the gpuTypes filter and the GPU/kernel/driver/firmware/agentVersion sort fields, which apply only to in-band-enrolled nodes.
	//
	// Corresponds with GET /v1/nodes/options (the `GetV1NodesOptions` operationId).
	GetV1NodesOptions(ctx context.Context, params *GetV1NodesOptionsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// DeleteV1NodesNodeUuid Delete a node (soft delete)
	//
	// Soft delete a node by setting the deleted flag to true.
	//
	// Corresponds with DELETE /v1/nodes/{nodeUUID} (the `DeleteV1NodesNodeUuid` operationId).
	DeleteV1NodesNodeUuid(ctx context.Context, nodeUUID string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1NodesNodeUuid Get detailed node information
	//
	// Get detailed information about a specific node including resources, system info, and health status
	//
	// Corresponds with GET /v1/nodes/{nodeUUID} (the `GetV1NodesNodeUuid` operationId).
	GetV1NodesNodeUuid(ctx context.Context, nodeUUID string, params *GetV1NodesNodeUuidParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1NodesNodeUuidHealthHistory Get node health history
	//
	// Returns the health status timeline and summary for a node over a time window.
	//
	// Corresponds with GET /v1/nodes/{nodeUUID}/health_history (the `GetV1NodesNodeUuidHealthHistory` operationId).
	GetV1NodesNodeUuidHealthHistory(ctx context.Context, nodeUUID string, params *GetV1NodesNodeUuidHealthHistoryParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PutV1NodesNodeUuidTagsWithBody Set all tags for a node
	//
	// Set all tags for a node to exactly the provided list (PUT semantics - full replacement)
	//
	// Tag Validation Rules:
	// - Format: lowercase letters (a-z), numbers (0-9), hyphens (-), and underscores (_)
	// - Must start and end with alphanumeric characters
	// - Separators (hyphen, underscore) cannot be consecutive
	// - Maximum length: 50 characters
	// - Reserved names: null, none, undefined, true, false
	// - Examples: "gpu-health", "test_tag", "node123"
	//
	// Takes any type of body and a specified content type.
	//
	// Corresponds with PUT /v1/nodes/{nodeUUID}/tags (the `PutV1NodesNodeUuidTags` operationId).
	PutV1NodesNodeUuidTagsWithBody(ctx context.Context, nodeUUID string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PutV1NodesNodeUuidTags Set all tags for a node
	//
	// Set all tags for a node to exactly the provided list (PUT semantics - full replacement)
	//
	// Tag Validation Rules:
	// - Format: lowercase letters (a-z), numbers (0-9), hyphens (-), and underscores (_)
	// - Must start and end with alphanumeric characters
	// - Separators (hyphen, underscore) cannot be consecutive
	// - Maximum length: 50 characters
	// - Reserved names: null, none, undefined, true, false
	// - Examples: "gpu-health", "test_tag", "node123"
	//
	// Takes a body of the `application/json` content type.
	//
	// Corresponds with PUT /v1/nodes/{nodeUUID}/tags (the `PutV1NodesNodeUuidTags` operationId).
	PutV1NodesNodeUuidTags(ctx context.Context, nodeUUID string, body PutV1NodesNodeUuidTagsJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1NotificationDeliveryLog List notification delivery logs
	//
	// Get paginated notification delivery log entries for the customer, with optional filtering
	// by component, channel, status, alertUUID, and time range.
	//
	// Corresponds with GET /v1/notification_delivery_log (the `GetV1NotificationDeliveryLog` operationId).
	GetV1NotificationDeliveryLog(ctx context.Context, params *GetV1NotificationDeliveryLogParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1NotificationPreferences List notification preferences
	//
	// Get all notification preferences for the customer. The public resource name remains preferences for compatibility,
	// but each preference is now id-addressable and applies one configuration
	// (alert statuses, scope, and notification targets) to a set of components. Multiple
	// preferences may cover the same component. Returns an empty list if none are configured.
	//
	// Corresponds with GET /v1/notification_preferences (the `GetV1NotificationPreferences` operationId).
	GetV1NotificationPreferences(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PostV1NotificationPreferencesWithBody Create a notification preference
	//
	// Create a notification preference. The public path remains notification_preferences
	// for compatibility; each row is id-addressable and applies one configuration (alert statuses, scope,
	// notification targets) to one or more components. The settings apply equally to every
	// component listed. To give a component different settings, create a separate preference.
	//
	// notifiedOn: array of alert statuses to notify on. Valid values: Critical, Warning, Resolved.
	// If notifiedOn is empty or omitted, defaults to all three: [Critical, Warning, Resolved].
	//
	// Channel config structures:
	// - email:   {"recipients": ["addr@example.com", ...]}  (at least one required)
	// - slack:   {"recipients": ["channel@workspace.slack.com", ...]}  (at least one required)
	// - webhook: {"customerID": "cust-acme" (optional), "orgName": "0000000000000000" (optional), "webhookIDs": ["wh_abc123", ...]}  (at least one webhook ID required; customerID defaults to the current customer when omitted; orgName is round-tripped for UI display only)
	//
	// Takes any type of body and a specified content type.
	//
	// Corresponds with POST /v1/notification_preferences (the `PostV1NotificationPreferences` operationId).
	PostV1NotificationPreferencesWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PostV1NotificationPreferences Create a notification preference
	//
	// Create a notification preference. The public path remains notification_preferences
	// for compatibility; each row is id-addressable and applies one configuration (alert statuses, scope,
	// notification targets) to one or more components. The settings apply equally to every
	// component listed. To give a component different settings, create a separate preference.
	//
	// notifiedOn: array of alert statuses to notify on. Valid values: Critical, Warning, Resolved.
	// If notifiedOn is empty or omitted, defaults to all three: [Critical, Warning, Resolved].
	//
	// Channel config structures:
	// - email:   {"recipients": ["addr@example.com", ...]}  (at least one required)
	// - slack:   {"recipients": ["channel@workspace.slack.com", ...]}  (at least one required)
	// - webhook: {"customerID": "cust-acme" (optional), "orgName": "0000000000000000" (optional), "webhookIDs": ["wh_abc123", ...]}  (at least one webhook ID required; customerID defaults to the current customer when omitted; orgName is round-tripped for UI display only)
	//
	// Takes a body of the `application/json` content type.
	//
	// Corresponds with POST /v1/notification_preferences (the `PostV1NotificationPreferences` operationId).
	PostV1NotificationPreferences(ctx context.Context, body PostV1NotificationPreferencesJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// DeleteV1NotificationPreferenceByID Delete a notification preference by id
	//
	// Corresponds with DELETE /v1/notification_preferences/{id} (the `DeleteV1NotificationPreferenceByID` operationId).
	DeleteV1NotificationPreferenceByID(ctx context.Context, id string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1NotificationPreferenceByID Get a notification preference by id
	//
	// Corresponds with GET /v1/notification_preferences/{id} (the `GetV1NotificationPreferenceByID` operationId).
	GetV1NotificationPreferenceByID(ctx context.Context, id string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PutV1NotificationPreferenceByIDWithBody Update a notification preference
	//
	// Update the preference addressed by id. Uses the same body shape as create; components, notifiedOn, scope, and targets replace the stored configuration, while omitted active preserves the existing pause/resume toggle.
	//
	// Takes any type of body and a specified content type.
	//
	// Corresponds with PUT /v1/notification_preferences/{id} (the `PutV1NotificationPreferenceByID` operationId).
	PutV1NotificationPreferenceByIDWithBody(ctx context.Context, id string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PutV1NotificationPreferenceByID Update a notification preference
	//
	// Update the preference addressed by id. Uses the same body shape as create; components, notifiedOn, scope, and targets replace the stored configuration, while omitted active preserves the existing pause/resume toggle.
	//
	// Takes a body of the `application/json` content type.
	//
	// Corresponds with PUT /v1/notification_preferences/{id} (the `PutV1NotificationPreferenceByID` operationId).
	PutV1NotificationPreferenceByID(ctx context.Context, id string, body PutV1NotificationPreferenceByIDJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1Overview Get overview
	//
	// Get overview of the system.
	//
	// Corresponds with GET /v1/overview (the `GetV1Overview` operationId).
	GetV1Overview(ctx context.Context, params *GetV1OverviewParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1ReportsError Get error report
	//
	// Get error report grouped by error type or node in JSON or CSV format. Default response is JSON. For CSV download (list view only), set format=csv query parameter. Response structure varies based on view and groupBy parameters:
	// - When view=list and groupBy=error: The 'errors' field is populated with paginated list
	// - When view=list and groupBy=node: The 'nodes' field is populated with paginated list
	// - When view=graph and groupBy=error: Returns time-series data with optional step parameter (page and pageSize not used)
	// - When view=overview: Returns aggregate statistics (groupBy parameter not required, page and pageSize not used)
	//
	// Corresponds with GET /v1/reports/error (the `GetV1ReportsError` operationId).
	GetV1ReportsError(ctx context.Context, params *GetV1ReportsErrorParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1ReportsInventory Get inventory report
	//
	// Get inventory report in JSON or CSV format. Default response is JSON. For CSV download, set format=csv. For a signed CSV bundle (CSV plus a cosign-verifiable signature, packaged as a zip), set format=csv and signed=true.
	// Each node includes enrolledAt (original enrollment time, preserved across re-enrollment) and removedAt (soft-delete time for removed nodes, manual and auto-removed alike; absent for active nodes).
	//
	// Corresponds with GET /v1/reports/inventory (the `GetV1ReportsInventory` operationId).
	GetV1ReportsInventory(ctx context.Context, params *GetV1ReportsInventoryParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1RetentionPolicy Get data retention policy
	//
	// Returns the customer's current data retention policy (retention period in days).
	//
	// Corresponds with GET /v1/retention_policy (the `GetV1RetentionPolicy` operationId).
	GetV1RetentionPolicy(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PutV1RetentionPolicyWithBody Update data retention policy
	//
	// Sets the customer's data retention period (1–365 days). Returns 204 No Content on success.
	//
	// Takes any type of body and a specified content type.
	//
	// Corresponds with PUT /v1/retention_policy (the `PutV1RetentionPolicy` operationId).
	PutV1RetentionPolicyWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PutV1RetentionPolicy Update data retention policy
	//
	// Sets the customer's data retention period (1–365 days). Returns 204 No Content on success.
	//
	// Takes a body of the `application/json` content type.
	//
	// Corresponds with PUT /v1/retention_policy (the `PutV1RetentionPolicy` operationId).
	PutV1RetentionPolicy(ctx context.Context, body PutV1RetentionPolicyJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1Tags List all unique tags
	//
	// Returns all unique tags for the customer with optional filtering.
	// Supports filtering by prefix, node UUID, node group ID, or compute zone ID.
	// At most one of nodeUUID, nodeGroupId, or computeZoneId can be specified.
	// Prefix can be combined with any of the other filters.
	//
	// Corresponds with GET /v1/tags (the `GetV1Tags` operationId).
	GetV1Tags(ctx context.Context, params *GetV1TagsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PatchV1TagsWithBody Batch update tags for multiple nodes
	//
	// Add and/or remove tags for multiple nodes in a single atomic operation.
	// Returns 204 No Content on success. Fails if all nodes are invalid.
	//
	// Tag Validation Rules (applies to tags being added):
	// - Format: lowercase letters (a-z), numbers (0-9), hyphens (-), and underscores (_)
	// - Must start and end with alphanumeric characters
	// - Separators (hyphen, underscore) cannot be consecutive
	// - Maximum length: 50 characters
	// - Reserved names: null, none, undefined, true, false
	// - Examples: "gpu-health", "test_tag", "node123"
	//
	// Note: Tags being removed are not validated, allowing removal of invalid legacy tags.
	//
	// Takes any type of body and a specified content type.
	//
	// Corresponds with PATCH /v1/tags (the `PatchV1Tags` operationId).
	PatchV1TagsWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	// PatchV1Tags Batch update tags for multiple nodes
	//
	// Add and/or remove tags for multiple nodes in a single atomic operation.
	// Returns 204 No Content on success. Fails if all nodes are invalid.
	//
	// Tag Validation Rules (applies to tags being added):
	// - Format: lowercase letters (a-z), numbers (0-9), hyphens (-), and underscores (_)
	// - Must start and end with alphanumeric characters
	// - Separators (hyphen, underscore) cannot be consecutive
	// - Maximum length: 50 characters
	// - Reserved names: null, none, undefined, true, false
	// - Examples: "gpu-health", "test_tag", "node123"
	//
	// Note: Tags being removed are not validated, allowing removal of invalid legacy tags.
	//
	// Takes a body of the `application/json` content type.
	//
	// Corresponds with PATCH /v1/tags (the `PatchV1Tags` operationId).
	PatchV1Tags(ctx context.Context, body PatchV1TagsJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1XIDBursts List finalized XID bursts
	//
	// Returns the flat finalized-burst table for the authenticated customer. Results default to startTime descending (latest first), with burstId descending as the stable pagination tie-breaker.
	// The selected time range applies to burst start time using [startTime, endTime) and is required, matching GET /v1/events. Relative mode requires timeMode=relative and a positive Go duration window; absolute mode (default) requires startTime and endTime. Do not combine window with startTime/endTime. Absolute endTime must be after startTime.
	// Node-group and compute-zone filters use customer-scoped UUIDs, matching the node and alert APIs. Values are OR-combined within each dimension and AND-combined across dimensions. Exclusion filters select every assignment except the supplied IDs and cannot be combined with the inclusive filter for the same dimension. Filter option IDs and labels are available from GET /v1/nodes/options. Bursts on soft-deleted nodes are never returned.
	// Multiple xidNumbers are OR-combined: a burst matches if it contains any of the requested XIDs (including bursts that contain only one of them, or both). String search parameters are case-insensitive substring filters. Categories, subcategories, and action-code array parameters (e.g. tenantActions) are exact-match checkbox-style filters, OR-combined within the same parameter; their values come from GET /v1/xid/bursts/options. All filters across different columns/parameters are AND-combined, including a *Search param and its exact-match sibling. Action filters and searches match catalog action codes (not Guidance Classes text) and expand public alias codes (e.g. CONTACT_SUPPORT) to the raw DB forms they replace (RETURN_TO_PROVIDER, PULL_FROM_SERVICE), so options-published codes match stored bursts.
	// Response fields are shaped server-side from the caller's persona. Tenants receive jobDisruption, XID numbers with mnemonics, and tenant actions. Cloud-provider/NCP callers additionally receive category, subcategory, jobDisruptionDueToPlatformIssue, XID catalog descriptions, and DC-admin actions. Action text is resolved from the persona-appropriate Guidance Classes catalog. Each item includes nodeUuid, hostname, and the node's current nodeGroup/computeZone (display names and IDs), matching alert timeline Level 1 inventory enrichment.
	//
	// Corresponds with GET /v1/xid/bursts (the `GetV1XIDBursts` operationId).
	GetV1XIDBursts(ctx context.Context, params *GetV1XIDBurstsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1XIDBurstOptions Get XID burst filter options
	//
	// Returns all filter options available to the authenticated customer and persona. Options are not narrowed by the table's current time, scope, or column filters. This v1 response contains no counts and has no cross-filter impact-count behavior.
	// Tenant callers receive public disruption values, XIDs, and tenant actions. Cloud-provider/NCP callers additionally receive platform-disruption values, categories, subcategories, and DC-admin actions. suggestedActions uses the shared action model; clients group it by persona and type. Category and action labels are resolved from the persona-appropriate catalogs.
	// jobDisruption and jobDisruptionDueToPlatformIssue are always the full [true, false] domain. XID numbers, categories, subcategories, and suggestedActions reflect the distinct values actually present across the customer's finalized bursts (still unfiltered by the current table filters). Action codes are alias-normalized and de-duplicated after normalization, matching GET /v1/xid/bursts. Hostname filtering uses the free-text hostnameSearch parameter on GET /v1/xid/bursts rather than a distinct-hostname options list.
	//
	// Corresponds with GET /v1/xid/bursts/options (the `GetV1XIDBurstOptions` operationId).
	GetV1XIDBurstOptions(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV1XIDBurstDetail Get finalized XID burst details
	//
	// Returns the side-panel details for one finalized burst belonging to the authenticated customer.
	// Response fields are shaped server-side from the caller's persona. Tenants receive the public job-disruption value, XID numbers with mnemonics, and tenant actions. Cloud-provider/NCP callers additionally receive category, subcategory, platform-attributed disruption, XID catalog descriptions, and all tenant plus DC-admin actions. Suggested action text is resolved from the persona-appropriate Guidance Classes catalog. The response includes nodeUuid, hostname, and the node's current nodeGroup/computeZone (display names and IDs).
	//
	// Corresponds with GET /v1/xid/bursts/{burstId} (the `GetV1XIDBurstDetail` operationId).
	GetV1XIDBurstDetail(ctx context.Context, burstId string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV2Commands Get commands (v2)
	//
	// Get list of commands (v2).
	//
	// Corresponds with GET /v2/commands (the `GetV2Commands` operationId).
	GetV2Commands(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetV2Metrics Get aggregated metrics with time series for any aggregation level
	//
	// Returns historical chart data for customer, node group, compute zone, or node level. The service selects the appropriate query path for each metric and aggregation level. Aggregation functions are determined by metric configuration in base-config.yaml.
	//
	// Corresponds with GET /v2/metrics (the `GetV2Metrics` operationId).
	GetV2Metrics(ctx context.Context, params *GetV2MetricsParams, reqEditors ...RequestEditorFn) (*http.Response, error)
}

type ClientOption func(*Client) error

type ClientWithResponses struct {
	ClientInterface
}

type ClientWithResponsesInterface interface {

	// GetWellKnownSigningKeyPubWithResponse Get inventory-report public verification key
	//
	// Returns NVIDIA's currently-active public key for verifying signed inventory reports. Use with `cosign verify-blob --key signing-key.pub --bundle <file>.sig.bundle <file>.csv`. The key is PEM-encoded (PKIX SubjectPublicKeyInfo). After a key rotation this URL serves the new key; reports signed under previous keys cease to verify and customers must re-download.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /.well-known/signing-key.pub (the `GetWellKnownSigningKeyPub` operationId).
	GetWellKnownSigningKeyPubWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*GetWellKnownSigningKeyPubResponse, error)

	// DeleteV1AlertMuteRulesWithBodyWithResponse Delete mute rules
	//
	// Delete mute rules for a specific component, or delete all mute rules for the customer.
	// With body: provide component (required) and optionally severities. If severities is empty, deletes all rules for the component.
	// Without body: deletes ALL mute rules for the customer.
	//
	// Takes any type of body and a specified content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with DELETE /v1/alert_mute_rules (the `DeleteV1AlertMuteRules` operationId).
	DeleteV1AlertMuteRulesWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*DeleteV1AlertMuteRulesResponse, error)

	// DeleteV1AlertMuteRulesWithResponse Delete mute rules
	//
	// Delete mute rules for a specific component, or delete all mute rules for the customer.
	// With body: provide component (required) and optionally severities. If severities is empty, deletes all rules for the component.
	// Without body: deletes ALL mute rules for the customer.
	//
	// Takes a body of the `application/json` content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with DELETE /v1/alert_mute_rules (the `DeleteV1AlertMuteRules` operationId).
	DeleteV1AlertMuteRulesWithResponse(ctx context.Context, body DeleteV1AlertMuteRulesJSONRequestBody, reqEditors ...RequestEditorFn) (*DeleteV1AlertMuteRulesResponse, error)

	// GetV1AlertMuteRulesWithResponse List mute rules
	//
	// Get all customer-wide mute rules grouped by component. Each component shows which severities (Critical, Warning) are muted.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/alert_mute_rules (the `GetV1AlertMuteRules` operationId).
	GetV1AlertMuteRulesWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*GetV1AlertMuteRulesResponse, error)

	// PutV1AlertMuteRulesWithBodyWithResponse Update mute rule for a component
	//
	// Declarative per-component update: set this component to exactly the specified severities.
	// If severities is empty or omitted, defaults to both Critical and Warning.
	// This replaces any existing mute configuration for the component.
	// Returns 204 No Content on success. Use GET /v1/alert_mute_rules to retrieve current state.
	//
	// Takes any type of body and a specified content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PUT /v1/alert_mute_rules (the `PutV1AlertMuteRules` operationId).
	PutV1AlertMuteRulesWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*PutV1AlertMuteRulesResponse, error)

	// PutV1AlertMuteRulesWithResponse Update mute rule for a component
	//
	// Declarative per-component update: set this component to exactly the specified severities.
	// If severities is empty or omitted, defaults to both Critical and Warning.
	// This replaces any existing mute configuration for the component.
	// Returns 204 No Content on success. Use GET /v1/alert_mute_rules to retrieve current state.
	//
	// Takes a body of the `application/json` content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PUT /v1/alert_mute_rules (the `PutV1AlertMuteRules` operationId).
	PutV1AlertMuteRulesWithResponse(ctx context.Context, body PutV1AlertMuteRulesJSONRequestBody, reqEditors ...RequestEditorFn) (*PutV1AlertMuteRulesResponse, error)

	// GetV1AlertTimelineFilterOptionsWithResponse Get filter dropdown options for the alert panel
	//
	// Get the set of filter values (GPU types, node groups, compute zones, component types, alert states) available for the alert panel, returned in the shared options envelope (filters.fields[] + sorting) used by the node and node-group options endpoints. Every value is scoped to the customer's alerts in the chosen view, so each option is guaranteed to return results when applied as a filter. Use the 'active' parameter to switch between the Active and Historical views; the historical view may additionally surface the Resolved alert state. Object-valued options ({id, value}) carry the filter id and its display value (node group / compute zone ids and names; component identifier and display name); gpuTypes and alertStates are plain strings. The sorting block advertises the Level 1 nodes-list sort columns. componentVisibility is resolved server-side from the caller's persona.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/alert_timeline/filter_options (the `GetV1AlertTimelineFilterOptions` operationId).
	GetV1AlertTimelineFilterOptionsWithResponse(ctx context.Context, params *GetV1AlertTimelineFilterOptionsParams, reqEditors ...RequestEditorFn) (*GetV1AlertTimelineFilterOptionsResponse, error)

	// GetV1AlertTimelineNodesWithResponse List impacted machines with alert summary (level 1)
	//
	// Returns a paginated list of nodes with per-node alert counts and inventory metadata for the Alerts panel. Use active=true for the Active Alerts view (only nodes with currently active alerts) or active=false for Historical Alerts. Cross-page aggregates (totalCritical, totalWarning, distinctGpuTypeCount, etc.) reflect the full filtered result set and drive table header counts. componentVisibility is resolved server-side from the user's auth persona and is not an HTTP parameter.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/alert_timeline/nodes (the `GetV1AlertTimelineNodes` operationId).
	GetV1AlertTimelineNodesWithResponse(ctx context.Context, params *GetV1AlertTimelineNodesParams, reqEditors ...RequestEditorFn) (*GetV1AlertTimelineNodesResponse, error)

	// GetV1AlertTimelineNodesNodeUuidAlertsWithResponse Get alerts for a specific node (level 2)
	//
	// Get list of alerts for a specific node. Returns alert UUID, component, alert status, start time, and last event time. Use the 'active' parameter to switch between active and historical views. The sortable table-header columns and the filter dimensions mirror the Level 1 nodes list, so the panel can forward the same filter set unchanged.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/alert_timeline/nodes/{nodeUUID}/alerts (the `GetV1AlertTimelineNodesNodeUuidAlerts` operationId).
	GetV1AlertTimelineNodesNodeUuidAlertsWithResponse(ctx context.Context, nodeUUID string, params *GetV1AlertTimelineNodesNodeUuidAlertsParams, reqEditors ...RequestEditorFn) (*GetV1AlertTimelineNodesNodeUuidAlertsResponse, error)

	// GetV1AlertTimelineNodesNodeUuidAlertsAlertUuidWithResponse Get complete timeline for a specific alert (level 3)
	//
	// Get complete timeline for a specific alert. Returns alert UUID, component, current alertStatus, nodeGroup, computeZone, and complete event timeline. This is the third level of the progressive disclosure API for alert timelines. Events default to newest-first (most recent update first); pass order=asc for chronological (oldest-first) order. Pagination of the timeline events is optional and backward compatible: omit pageSize to receive the full timeline (default); supply pageSize to page through the events, in which case the response also carries page/pageSize/total/hasMore metadata.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/alert_timeline/nodes/{nodeUUID}/alerts/{alertUUID} (the `GetV1AlertTimelineNodesNodeUuidAlertsAlertUuid` operationId).
	GetV1AlertTimelineNodesNodeUuidAlertsAlertUuidWithResponse(ctx context.Context, nodeUUID string, alertUUID string, params *GetV1AlertTimelineNodesNodeUuidAlertsAlertUuidParams, reqEditors ...RequestEditorFn) (*GetV1AlertTimelineNodesNodeUuidAlertsAlertUuidResponse, error)

	// GetV1AlertsWithResponse Get alerts
	//
	// Get list of alerts with optional filtering by node, component, state, and severity
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/alerts (the `GetV1Alerts` operationId).
	GetV1AlertsWithResponse(ctx context.Context, params *GetV1AlertsParams, reqEditors ...RequestEditorFn) (*GetV1AlertsResponse, error)

	// GetV1AlertsNodeUuidWithResponse Get alerts for a specific node
	//
	// Get list of alerts for a specific node (machine) identified by nodeUUID, grouped by component
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/alerts/{nodeUUID} (the `GetV1AlertsNodeUuid` operationId).
	GetV1AlertsNodeUuidWithResponse(ctx context.Context, nodeUUID string, params *GetV1AlertsNodeUuidParams, reqEditors ...RequestEditorFn) (*GetV1AlertsNodeUuidResponse, error)

	// GetV1AuthStatusWithResponse Get authentication status
	//
	// Returns whether the request reached the backend through the authenticated KAS path.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/auth/status (the `GetV1AuthStatus` operationId).
	GetV1AuthStatusWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*GetV1AuthStatusResponse, error)

	// GetV1ComputezonesWithResponse Get compute zones
	//
	// Get list of compute zones with optional filtering and different view modes. Use view=detail for comprehensive metrics and view=basic for essential fields (ID, Name, Type, GeoLocation, Contact, timestamps)
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/computezones (the `GetV1Computezones` operationId).
	GetV1ComputezonesWithResponse(ctx context.Context, params *GetV1ComputezonesParams, reqEditors ...RequestEditorFn) (*GetV1ComputezonesResponse, error)

	// PutV1ComputezonesWithBodyWithResponse Update compute zone
	//
	// Admin updates compute zone type and metadata. Compute zone names are agent-managed and cannot be changed from customer-api.
	//
	// Takes any type of body and a specified content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PUT /v1/computezones (the `PutV1Computezones` operationId).
	PutV1ComputezonesWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*PutV1ComputezonesResponse, error)

	// PutV1ComputezonesWithResponse Update compute zone
	//
	// Admin updates compute zone type and metadata. Compute zone names are agent-managed and cannot be changed from customer-api.
	//
	// Takes a body of the `application/json` content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PUT /v1/computezones (the `PutV1Computezones` operationId).
	PutV1ComputezonesWithResponse(ctx context.Context, body PutV1ComputezonesJSONRequestBody, reqEditors ...RequestEditorFn) (*PutV1ComputezonesResponse, error)

	// GetV1EventsWithResponse Get events
	//
	// Get list of events with optional filtering by node UUID, component, and time range. Returns events from the events table for the specified time period.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/events (the `GetV1Events` operationId).
	GetV1EventsWithResponse(ctx context.Context, params *GetV1EventsParams, reqEditors ...RequestEditorFn) (*GetV1EventsResponse, error)

	// GetV1EventsBucketsWithResponse Get event counts bucketed by time
	//
	// Returns time-bucketed event counts for histogram display. The server picks a clean bucket interval based on the maxBuckets hint.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/events/buckets (the `GetV1EventsBuckets` operationId).
	GetV1EventsBucketsWithResponse(ctx context.Context, params *GetV1EventsBucketsParams, reqEditors ...RequestEditorFn) (*GetV1EventsBucketsResponse, error)

	// GetV1InfoWithResponse Get application info
	//
	// Get version and build information for API backend and agent backend components, plus the current inventory-report signing key's rotation freshness.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/info (the `GetV1Info` operationId).
	GetV1InfoWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*GetV1InfoResponse, error)

	// GetV1MetricsWithResponse Get available metrics
	//
	// Get a list of all available metrics, organized by component. Supports optional filtering by isCritical, aggregatable, and type. Unknown or false values for boolean params are treated as no filter.
	// Use psirtComponent=true to include active PSIRT CVE sub-components under the "psirt" component.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/metrics (the `GetV1Metrics` operationId).
	GetV1MetricsWithResponse(ctx context.Context, params *GetV1MetricsParams, reqEditors ...RequestEditorFn) (*GetV1MetricsResponse, error)

	// GetV1MetricsQueryRangeWithResponse Query metric range
	//
	// Query data for a particular metric for a node, node group, or compute zone over a range of time
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/metrics/query_range (the `GetV1MetricsQueryRange` operationId).
	GetV1MetricsQueryRangeWithResponse(ctx context.Context, params *GetV1MetricsQueryRangeParams, reqEditors ...RequestEditorFn) (*GetV1MetricsQueryRangeResponse, error)

	// GetV1NodeGroupMembershipsWithResponse Get node group memberships
	//
	// Get list of node group memberships with optional filtering. Customer ID is automatically extracted from the NV-ngc-nca-id header and used for filtering.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/node_group_memberships (the `GetV1NodeGroupMemberships` operationId).
	GetV1NodeGroupMembershipsWithResponse(ctx context.Context, params *GetV1NodeGroupMembershipsParams, reqEditors ...RequestEditorFn) (*GetV1NodeGroupMembershipsResponse, error)

	// GetV1NodeRemovalPolicyWithResponse Get auto node removal policy
	//
	// Returns the customer's "Auto remove machines" settings. Customers that never
	// configured the policy get the defaults (disabled, offlineThreshold omitted).
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/node_removal_policy (the `GetV1NodeRemovalPolicy` operationId).
	GetV1NodeRemovalPolicyWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*GetV1NodeRemovalPolicyResponse, error)

	// PutV1NodeRemovalPolicyWithBodyWithResponse Update auto node removal policy
	//
	// Updates the customer's "Auto remove machines" settings. When offlineThreshold
	// is omitted the stored threshold is kept (disabling never clears it), so it is
	// required only when enabling for the first time. The equivalent duration must be
	// at least 1 day (whole numbers). An omitted enabled binds as false.
	// Returns 204 No Content on success.
	//
	// Takes any type of body and a specified content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PUT /v1/node_removal_policy (the `PutV1NodeRemovalPolicy` operationId).
	PutV1NodeRemovalPolicyWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*PutV1NodeRemovalPolicyResponse, error)

	// PutV1NodeRemovalPolicyWithResponse Update auto node removal policy
	//
	// Updates the customer's "Auto remove machines" settings. When offlineThreshold
	// is omitted the stored threshold is kept (disabling never clears it), so it is
	// required only when enabling for the first time. The equivalent duration must be
	// at least 1 day (whole numbers). An omitted enabled binds as false.
	// Returns 204 No Content on success.
	//
	// Takes a body of the `application/json` content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PUT /v1/node_removal_policy (the `PutV1NodeRemovalPolicy` operationId).
	PutV1NodeRemovalPolicyWithResponse(ctx context.Context, body PutV1NodeRemovalPolicyJSONRequestBody, reqEditors ...RequestEditorFn) (*PutV1NodeRemovalPolicyResponse, error)

	// GetV1NodegroupsWithResponse Get node groups
	//
	// Get list of node groups with optional filtering and different view modes. Use view=detail for comprehensive metrics and view=basic for minimal ID/Name list. Detail view supports additional filters: computeZoneNames (partial match), healthStatuses, and gpuTypes
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/nodegroups (the `GetV1Nodegroups` operationId).
	GetV1NodegroupsWithResponse(ctx context.Context, params *GetV1NodegroupsParams, reqEditors ...RequestEditorFn) (*GetV1NodegroupsResponse, error)

	// GetV1NodegroupsOptionsWithResponse Get available query options for node groups
	//
	// Returns available filters and sorting options for querying node groups.
	// Filter options may be simple strings (e.g., health statuses, GPU types) or hierarchical objects (e.g., compute zones with nested nodegroups).
	//
	// Filter options examples:
	// - Simple strings: `{"name": "healthStatuses", "options": ["Healthy", "Degraded", "Unhealthy"]}`
	// - Hierarchical objects: `{"name": "computeZones", "options": [{"id": "cz-1", "value": "Zone 1", "options": [{"id": "ng-1", "value": "Node Group 1"}]}]}`
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/nodegroups/options (the `GetV1NodegroupsOptions` operationId).
	GetV1NodegroupsOptionsWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*GetV1NodegroupsOptionsResponse, error)

	// DeleteV1NodesWithBodyWithResponse Delete multiple nodes (soft delete)
	//
	// Soft delete multiple nodes by setting the deleted flag to true.
	//
	// Takes any type of body and a specified content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with DELETE /v1/nodes (the `DeleteV1Nodes` operationId).
	DeleteV1NodesWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*DeleteV1NodesResponse, error)

	// DeleteV1NodesWithResponse Delete multiple nodes (soft delete)
	//
	// Soft delete multiple nodes by setting the deleted flag to true.
	//
	// Takes a body of the `application/json` content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with DELETE /v1/nodes (the `DeleteV1Nodes` operationId).
	DeleteV1NodesWithResponse(ctx context.Context, body DeleteV1NodesJSONRequestBody, reqEditors ...RequestEditorFn) (*DeleteV1NodesResponse, error)

	// GetV1NodesWithResponse Get nodes overview and states
	//
	// Get list of nodes with current state and overview. Use view=detail (default) for full response or view=basic for a lightweight nodeUUID + hostname list (see models.BasicNodesResponse). All filter parameters are optional arrays - empty means no filter applied.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/nodes (the `GetV1Nodes` operationId).
	GetV1NodesWithResponse(ctx context.Context, params *GetV1NodesParams, reqEditors ...RequestEditorFn) (*GetV1NodesResponse, error)

	// GetV1NodesHistoryWithResponse List node removal history
	//
	// Returns removed machines for the customer, newest first. Covers both
	// auto-removed (actorType system, deleted by the node reaper) and manually
	// deleted (actorType user) nodes. The same machine may appear multiple times
	// across remove/re-enroll cycles.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/nodes/history (the `GetV1NodesHistory` operationId).
	GetV1NodesHistoryWithResponse(ctx context.Context, params *GetV1NodesHistoryParams, reqEditors ...RequestEditorFn) (*GetV1NodesHistoryResponse, error)

	// GetV1NodesOptionsWithResponse Get available query options for nodes
	//
	// Returns available filters and sorting options for querying nodes.
	// Filter options may be simple strings (e.g., health statuses) or hierarchical objects (e.g., compute zones with nested nodegroups).
	//
	// Filter options examples:
	// - Simple strings: `{"name": "healthStatuses", "options": ["Healthy", "Degraded", "Unhealthy"]}`
	// - Hierarchical objects: `{"name": "computeZones", "options": [{"id": "cz-1", "value": "Zone 1", "options": [{"id": "ng-1", "value": "Node Group 1"}]}]}`
	//
	// The available options depend on the agentType view. The OOB view omits the gpuTypes filter and the GPU/kernel/driver/firmware/agentVersion sort fields, which apply only to in-band-enrolled nodes.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/nodes/options (the `GetV1NodesOptions` operationId).
	GetV1NodesOptionsWithResponse(ctx context.Context, params *GetV1NodesOptionsParams, reqEditors ...RequestEditorFn) (*GetV1NodesOptionsResponse, error)

	// DeleteV1NodesNodeUuidWithResponse Delete a node (soft delete)
	//
	// Soft delete a node by setting the deleted flag to true.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with DELETE /v1/nodes/{nodeUUID} (the `DeleteV1NodesNodeUuid` operationId).
	DeleteV1NodesNodeUuidWithResponse(ctx context.Context, nodeUUID string, reqEditors ...RequestEditorFn) (*DeleteV1NodesNodeUuidResponse, error)

	// GetV1NodesNodeUuidWithResponse Get detailed node information
	//
	// Get detailed information about a specific node including resources, system info, and health status
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/nodes/{nodeUUID} (the `GetV1NodesNodeUuid` operationId).
	GetV1NodesNodeUuidWithResponse(ctx context.Context, nodeUUID string, params *GetV1NodesNodeUuidParams, reqEditors ...RequestEditorFn) (*GetV1NodesNodeUuidResponse, error)

	// GetV1NodesNodeUuidHealthHistoryWithResponse Get node health history
	//
	// Returns the health status timeline and summary for a node over a time window.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/nodes/{nodeUUID}/health_history (the `GetV1NodesNodeUuidHealthHistory` operationId).
	GetV1NodesNodeUuidHealthHistoryWithResponse(ctx context.Context, nodeUUID string, params *GetV1NodesNodeUuidHealthHistoryParams, reqEditors ...RequestEditorFn) (*GetV1NodesNodeUuidHealthHistoryResponse, error)

	// PutV1NodesNodeUuidTagsWithBodyWithResponse Set all tags for a node
	//
	// Set all tags for a node to exactly the provided list (PUT semantics - full replacement)
	//
	// Tag Validation Rules:
	// - Format: lowercase letters (a-z), numbers (0-9), hyphens (-), and underscores (_)
	// - Must start and end with alphanumeric characters
	// - Separators (hyphen, underscore) cannot be consecutive
	// - Maximum length: 50 characters
	// - Reserved names: null, none, undefined, true, false
	// - Examples: "gpu-health", "test_tag", "node123"
	//
	// Takes any type of body and a specified content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PUT /v1/nodes/{nodeUUID}/tags (the `PutV1NodesNodeUuidTags` operationId).
	PutV1NodesNodeUuidTagsWithBodyWithResponse(ctx context.Context, nodeUUID string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*PutV1NodesNodeUuidTagsResponse, error)

	// PutV1NodesNodeUuidTagsWithResponse Set all tags for a node
	//
	// Set all tags for a node to exactly the provided list (PUT semantics - full replacement)
	//
	// Tag Validation Rules:
	// - Format: lowercase letters (a-z), numbers (0-9), hyphens (-), and underscores (_)
	// - Must start and end with alphanumeric characters
	// - Separators (hyphen, underscore) cannot be consecutive
	// - Maximum length: 50 characters
	// - Reserved names: null, none, undefined, true, false
	// - Examples: "gpu-health", "test_tag", "node123"
	//
	// Takes a body of the `application/json` content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PUT /v1/nodes/{nodeUUID}/tags (the `PutV1NodesNodeUuidTags` operationId).
	PutV1NodesNodeUuidTagsWithResponse(ctx context.Context, nodeUUID string, body PutV1NodesNodeUuidTagsJSONRequestBody, reqEditors ...RequestEditorFn) (*PutV1NodesNodeUuidTagsResponse, error)

	// GetV1NotificationDeliveryLogWithResponse List notification delivery logs
	//
	// Get paginated notification delivery log entries for the customer, with optional filtering
	// by component, channel, status, alertUUID, and time range.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/notification_delivery_log (the `GetV1NotificationDeliveryLog` operationId).
	GetV1NotificationDeliveryLogWithResponse(ctx context.Context, params *GetV1NotificationDeliveryLogParams, reqEditors ...RequestEditorFn) (*GetV1NotificationDeliveryLogResponse, error)

	// GetV1NotificationPreferencesWithResponse List notification preferences
	//
	// Get all notification preferences for the customer. The public resource name remains preferences for compatibility,
	// but each preference is now id-addressable and applies one configuration
	// (alert statuses, scope, and notification targets) to a set of components. Multiple
	// preferences may cover the same component. Returns an empty list if none are configured.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/notification_preferences (the `GetV1NotificationPreferences` operationId).
	GetV1NotificationPreferencesWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*GetV1NotificationPreferencesResponse, error)

	// PostV1NotificationPreferencesWithBodyWithResponse Create a notification preference
	//
	// Create a notification preference. The public path remains notification_preferences
	// for compatibility; each row is id-addressable and applies one configuration (alert statuses, scope,
	// notification targets) to one or more components. The settings apply equally to every
	// component listed. To give a component different settings, create a separate preference.
	//
	// notifiedOn: array of alert statuses to notify on. Valid values: Critical, Warning, Resolved.
	// If notifiedOn is empty or omitted, defaults to all three: [Critical, Warning, Resolved].
	//
	// Channel config structures:
	// - email:   {"recipients": ["addr@example.com", ...]}  (at least one required)
	// - slack:   {"recipients": ["channel@workspace.slack.com", ...]}  (at least one required)
	// - webhook: {"customerID": "cust-acme" (optional), "orgName": "0000000000000000" (optional), "webhookIDs": ["wh_abc123", ...]}  (at least one webhook ID required; customerID defaults to the current customer when omitted; orgName is round-tripped for UI display only)
	//
	// Takes any type of body and a specified content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with POST /v1/notification_preferences (the `PostV1NotificationPreferences` operationId).
	PostV1NotificationPreferencesWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*PostV1NotificationPreferencesResponse, error)

	// PostV1NotificationPreferencesWithResponse Create a notification preference
	//
	// Create a notification preference. The public path remains notification_preferences
	// for compatibility; each row is id-addressable and applies one configuration (alert statuses, scope,
	// notification targets) to one or more components. The settings apply equally to every
	// component listed. To give a component different settings, create a separate preference.
	//
	// notifiedOn: array of alert statuses to notify on. Valid values: Critical, Warning, Resolved.
	// If notifiedOn is empty or omitted, defaults to all three: [Critical, Warning, Resolved].
	//
	// Channel config structures:
	// - email:   {"recipients": ["addr@example.com", ...]}  (at least one required)
	// - slack:   {"recipients": ["channel@workspace.slack.com", ...]}  (at least one required)
	// - webhook: {"customerID": "cust-acme" (optional), "orgName": "0000000000000000" (optional), "webhookIDs": ["wh_abc123", ...]}  (at least one webhook ID required; customerID defaults to the current customer when omitted; orgName is round-tripped for UI display only)
	//
	// Takes a body of the `application/json` content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with POST /v1/notification_preferences (the `PostV1NotificationPreferences` operationId).
	PostV1NotificationPreferencesWithResponse(ctx context.Context, body PostV1NotificationPreferencesJSONRequestBody, reqEditors ...RequestEditorFn) (*PostV1NotificationPreferencesResponse, error)

	// DeleteV1NotificationPreferenceByIDWithResponse Delete a notification preference by id
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with DELETE /v1/notification_preferences/{id} (the `DeleteV1NotificationPreferenceByID` operationId).
	DeleteV1NotificationPreferenceByIDWithResponse(ctx context.Context, id string, reqEditors ...RequestEditorFn) (*DeleteV1NotificationPreferenceByIDResponse, error)

	// GetV1NotificationPreferenceByIDWithResponse Get a notification preference by id
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/notification_preferences/{id} (the `GetV1NotificationPreferenceByID` operationId).
	GetV1NotificationPreferenceByIDWithResponse(ctx context.Context, id string, reqEditors ...RequestEditorFn) (*GetV1NotificationPreferenceByIDResponse, error)

	// PutV1NotificationPreferenceByIDWithBodyWithResponse Update a notification preference
	//
	// Update the preference addressed by id. Uses the same body shape as create; components, notifiedOn, scope, and targets replace the stored configuration, while omitted active preserves the existing pause/resume toggle.
	//
	// Takes any type of body and a specified content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PUT /v1/notification_preferences/{id} (the `PutV1NotificationPreferenceByID` operationId).
	PutV1NotificationPreferenceByIDWithBodyWithResponse(ctx context.Context, id string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*PutV1NotificationPreferenceByIDResponse, error)

	// PutV1NotificationPreferenceByIDWithResponse Update a notification preference
	//
	// Update the preference addressed by id. Uses the same body shape as create; components, notifiedOn, scope, and targets replace the stored configuration, while omitted active preserves the existing pause/resume toggle.
	//
	// Takes a body of the `application/json` content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PUT /v1/notification_preferences/{id} (the `PutV1NotificationPreferenceByID` operationId).
	PutV1NotificationPreferenceByIDWithResponse(ctx context.Context, id string, body PutV1NotificationPreferenceByIDJSONRequestBody, reqEditors ...RequestEditorFn) (*PutV1NotificationPreferenceByIDResponse, error)

	// GetV1OverviewWithResponse Get overview
	//
	// Get overview of the system.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/overview (the `GetV1Overview` operationId).
	GetV1OverviewWithResponse(ctx context.Context, params *GetV1OverviewParams, reqEditors ...RequestEditorFn) (*GetV1OverviewResponse, error)

	// GetV1ReportsErrorWithResponse Get error report
	//
	// Get error report grouped by error type or node in JSON or CSV format. Default response is JSON. For CSV download (list view only), set format=csv query parameter. Response structure varies based on view and groupBy parameters:
	// - When view=list and groupBy=error: The 'errors' field is populated with paginated list
	// - When view=list and groupBy=node: The 'nodes' field is populated with paginated list
	// - When view=graph and groupBy=error: Returns time-series data with optional step parameter (page and pageSize not used)
	// - When view=overview: Returns aggregate statistics (groupBy parameter not required, page and pageSize not used)
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/reports/error (the `GetV1ReportsError` operationId).
	GetV1ReportsErrorWithResponse(ctx context.Context, params *GetV1ReportsErrorParams, reqEditors ...RequestEditorFn) (*GetV1ReportsErrorResponse, error)

	// GetV1ReportsInventoryWithResponse Get inventory report
	//
	// Get inventory report in JSON or CSV format. Default response is JSON. For CSV download, set format=csv. For a signed CSV bundle (CSV plus a cosign-verifiable signature, packaged as a zip), set format=csv and signed=true.
	// Each node includes enrolledAt (original enrollment time, preserved across re-enrollment) and removedAt (soft-delete time for removed nodes, manual and auto-removed alike; absent for active nodes).
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/reports/inventory (the `GetV1ReportsInventory` operationId).
	GetV1ReportsInventoryWithResponse(ctx context.Context, params *GetV1ReportsInventoryParams, reqEditors ...RequestEditorFn) (*GetV1ReportsInventoryResponse, error)

	// GetV1RetentionPolicyWithResponse Get data retention policy
	//
	// Returns the customer's current data retention policy (retention period in days).
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/retention_policy (the `GetV1RetentionPolicy` operationId).
	GetV1RetentionPolicyWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*GetV1RetentionPolicyResponse, error)

	// PutV1RetentionPolicyWithBodyWithResponse Update data retention policy
	//
	// Sets the customer's data retention period (1–365 days). Returns 204 No Content on success.
	//
	// Takes any type of body and a specified content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PUT /v1/retention_policy (the `PutV1RetentionPolicy` operationId).
	PutV1RetentionPolicyWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*PutV1RetentionPolicyResponse, error)

	// PutV1RetentionPolicyWithResponse Update data retention policy
	//
	// Sets the customer's data retention period (1–365 days). Returns 204 No Content on success.
	//
	// Takes a body of the `application/json` content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PUT /v1/retention_policy (the `PutV1RetentionPolicy` operationId).
	PutV1RetentionPolicyWithResponse(ctx context.Context, body PutV1RetentionPolicyJSONRequestBody, reqEditors ...RequestEditorFn) (*PutV1RetentionPolicyResponse, error)

	// GetV1TagsWithResponse List all unique tags
	//
	// Returns all unique tags for the customer with optional filtering.
	// Supports filtering by prefix, node UUID, node group ID, or compute zone ID.
	// At most one of nodeUUID, nodeGroupId, or computeZoneId can be specified.
	// Prefix can be combined with any of the other filters.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/tags (the `GetV1Tags` operationId).
	GetV1TagsWithResponse(ctx context.Context, params *GetV1TagsParams, reqEditors ...RequestEditorFn) (*GetV1TagsResponse, error)

	// PatchV1TagsWithBodyWithResponse Batch update tags for multiple nodes
	//
	// Add and/or remove tags for multiple nodes in a single atomic operation.
	// Returns 204 No Content on success. Fails if all nodes are invalid.
	//
	// Tag Validation Rules (applies to tags being added):
	// - Format: lowercase letters (a-z), numbers (0-9), hyphens (-), and underscores (_)
	// - Must start and end with alphanumeric characters
	// - Separators (hyphen, underscore) cannot be consecutive
	// - Maximum length: 50 characters
	// - Reserved names: null, none, undefined, true, false
	// - Examples: "gpu-health", "test_tag", "node123"
	//
	// Note: Tags being removed are not validated, allowing removal of invalid legacy tags.
	//
	// Takes any type of body and a specified content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PATCH /v1/tags (the `PatchV1Tags` operationId).
	PatchV1TagsWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*PatchV1TagsResponse, error)

	// PatchV1TagsWithResponse Batch update tags for multiple nodes
	//
	// Add and/or remove tags for multiple nodes in a single atomic operation.
	// Returns 204 No Content on success. Fails if all nodes are invalid.
	//
	// Tag Validation Rules (applies to tags being added):
	// - Format: lowercase letters (a-z), numbers (0-9), hyphens (-), and underscores (_)
	// - Must start and end with alphanumeric characters
	// - Separators (hyphen, underscore) cannot be consecutive
	// - Maximum length: 50 characters
	// - Reserved names: null, none, undefined, true, false
	// - Examples: "gpu-health", "test_tag", "node123"
	//
	// Note: Tags being removed are not validated, allowing removal of invalid legacy tags.
	//
	// Takes a body of the `application/json` content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PATCH /v1/tags (the `PatchV1Tags` operationId).
	PatchV1TagsWithResponse(ctx context.Context, body PatchV1TagsJSONRequestBody, reqEditors ...RequestEditorFn) (*PatchV1TagsResponse, error)

	// GetV1XIDBurstsWithResponse List finalized XID bursts
	//
	// Returns the flat finalized-burst table for the authenticated customer. Results default to startTime descending (latest first), with burstId descending as the stable pagination tie-breaker.
	// The selected time range applies to burst start time using [startTime, endTime) and is required, matching GET /v1/events. Relative mode requires timeMode=relative and a positive Go duration window; absolute mode (default) requires startTime and endTime. Do not combine window with startTime/endTime. Absolute endTime must be after startTime.
	// Node-group and compute-zone filters use customer-scoped UUIDs, matching the node and alert APIs. Values are OR-combined within each dimension and AND-combined across dimensions. Exclusion filters select every assignment except the supplied IDs and cannot be combined with the inclusive filter for the same dimension. Filter option IDs and labels are available from GET /v1/nodes/options. Bursts on soft-deleted nodes are never returned.
	// Multiple xidNumbers are OR-combined: a burst matches if it contains any of the requested XIDs (including bursts that contain only one of them, or both). String search parameters are case-insensitive substring filters. Categories, subcategories, and action-code array parameters (e.g. tenantActions) are exact-match checkbox-style filters, OR-combined within the same parameter; their values come from GET /v1/xid/bursts/options. All filters across different columns/parameters are AND-combined, including a *Search param and its exact-match sibling. Action filters and searches match catalog action codes (not Guidance Classes text) and expand public alias codes (e.g. CONTACT_SUPPORT) to the raw DB forms they replace (RETURN_TO_PROVIDER, PULL_FROM_SERVICE), so options-published codes match stored bursts.
	// Response fields are shaped server-side from the caller's persona. Tenants receive jobDisruption, XID numbers with mnemonics, and tenant actions. Cloud-provider/NCP callers additionally receive category, subcategory, jobDisruptionDueToPlatformIssue, XID catalog descriptions, and DC-admin actions. Action text is resolved from the persona-appropriate Guidance Classes catalog. Each item includes nodeUuid, hostname, and the node's current nodeGroup/computeZone (display names and IDs), matching alert timeline Level 1 inventory enrichment.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/xid/bursts (the `GetV1XIDBursts` operationId).
	GetV1XIDBurstsWithResponse(ctx context.Context, params *GetV1XIDBurstsParams, reqEditors ...RequestEditorFn) (*GetV1XIDBurstsResponse, error)

	// GetV1XIDBurstOptionsWithResponse Get XID burst filter options
	//
	// Returns all filter options available to the authenticated customer and persona. Options are not narrowed by the table's current time, scope, or column filters. This v1 response contains no counts and has no cross-filter impact-count behavior.
	// Tenant callers receive public disruption values, XIDs, and tenant actions. Cloud-provider/NCP callers additionally receive platform-disruption values, categories, subcategories, and DC-admin actions. suggestedActions uses the shared action model; clients group it by persona and type. Category and action labels are resolved from the persona-appropriate catalogs.
	// jobDisruption and jobDisruptionDueToPlatformIssue are always the full [true, false] domain. XID numbers, categories, subcategories, and suggestedActions reflect the distinct values actually present across the customer's finalized bursts (still unfiltered by the current table filters). Action codes are alias-normalized and de-duplicated after normalization, matching GET /v1/xid/bursts. Hostname filtering uses the free-text hostnameSearch parameter on GET /v1/xid/bursts rather than a distinct-hostname options list.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/xid/bursts/options (the `GetV1XIDBurstOptions` operationId).
	GetV1XIDBurstOptionsWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*GetV1XIDBurstOptionsResponse, error)

	// GetV1XIDBurstDetailWithResponse Get finalized XID burst details
	//
	// Returns the side-panel details for one finalized burst belonging to the authenticated customer.
	// Response fields are shaped server-side from the caller's persona. Tenants receive the public job-disruption value, XID numbers with mnemonics, and tenant actions. Cloud-provider/NCP callers additionally receive category, subcategory, platform-attributed disruption, XID catalog descriptions, and all tenant plus DC-admin actions. Suggested action text is resolved from the persona-appropriate Guidance Classes catalog. The response includes nodeUuid, hostname, and the node's current nodeGroup/computeZone (display names and IDs).
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v1/xid/bursts/{burstId} (the `GetV1XIDBurstDetail` operationId).
	GetV1XIDBurstDetailWithResponse(ctx context.Context, burstId string, reqEditors ...RequestEditorFn) (*GetV1XIDBurstDetailResponse, error)

	// GetV2CommandsWithResponse Get commands (v2)
	//
	// Get list of commands (v2).
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v2/commands (the `GetV2Commands` operationId).
	GetV2CommandsWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*GetV2CommandsResponse, error)

	// GetV2MetricsWithResponse Get aggregated metrics with time series for any aggregation level
	//
	// Returns historical chart data for customer, node group, compute zone, or node level. The service selects the appropriate query path for each metric and aggregation level. Aggregation functions are determined by metric configuration in base-config.yaml.
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /v2/metrics (the `GetV2Metrics` operationId).
	GetV2MetricsWithResponse(ctx context.Context, params *GetV2MetricsParams, reqEditors ...RequestEditorFn) (*GetV2MetricsResponse, error)
}