diff --git a/internal/cli/root.go b/internal/cli/root.go index ef6d835..a11ec54 100644 --- a/internal/cli/root.go +++ b/internal/cli/root.go @@ -258,13 +258,14 @@ func currentOutputFormat() output.Format { } // marshalStructured serializes v for machine-readable output: indented JSON for -// FormatJSON (byte-compatible with the legacy --json path) and TOON via the -// toon-format encoder for FormatTOON. +// FormatJSON (byte-compatible with the legacy --json path, except that unset +// SDK timestamps now render as null instead of the bare integer 0 — see +// output.NullUnsetInstants) and TOON via the toon-format encoder for FormatTOON. func marshalStructured(v any) ([]byte, error) { if currentOutputFormat() == output.FormatTOON { return toon.Marshal(v) } - return json.MarshalIndent(v, "", " ") + return json.MarshalIndent(output.NullUnsetInstants(v), "", " ") } // newPrinter creates a Printer based on global flags. diff --git a/internal/cli/session.go b/internal/cli/session.go index c22fbe0..51055ea 100644 --- a/internal/cli/session.go +++ b/internal/cli/session.go @@ -11,6 +11,7 @@ import ( "github.com/spf13/cobra" toon "github.com/toon-format/toon-go" + "github.com/flashcatcloud/flashduty-cli/internal/output" "github.com/flashcatcloud/flashduty-cli/internal/timeutil" ) @@ -229,13 +230,16 @@ func filterSessionsSince(sessions []flashduty.SessionItem, sinceUnix int64) []fl // writeSessionList renders the session rows in the requested format. jsonl emits // one SessionItem per line; json emits the whole SessionListResponse envelope; -// toon emits the compact encoding of that envelope. +// toon emits the compact encoding of that envelope. The json/jsonl paths route +// through output.NullUnsetInstants so unset SDK timestamps (e.g. archived_at +// on a live session) render as null instead of the bare integer 0, matching +// every other --json surface. func writeSessionList(w io.Writer, format string, sessions []flashduty.SessionItem, total int64) error { switch format { case sessionFormatJSONL: enc := json.NewEncoder(w) for i := range sessions { - if err := enc.Encode(sessions[i]); err != nil { + if err := enc.Encode(output.NullUnsetInstants(sessions[i])); err != nil { return fmt.Errorf("failed to encode session: %w", err) } } @@ -249,7 +253,7 @@ func writeSessionList(w io.Writer, format string, sessions []flashduty.SessionIt if format == sessionFormatTOON { out, err = toon.Marshal(envelope) } else { - out, err = json.MarshalIndent(envelope, "", " ") + out, err = json.MarshalIndent(output.NullUnsetInstants(envelope), "", " ") } if err != nil { return fmt.Errorf("failed to marshal sessions: %w", err) diff --git a/internal/cli/session_test.go b/internal/cli/session_test.go index 4b85c52..6dbd541 100644 --- a/internal/cli/session_test.go +++ b/internal/cli/session_test.go @@ -2,6 +2,7 @@ package cli import ( "bufio" + "bytes" "encoding/json" "fmt" "net/http" @@ -511,6 +512,61 @@ func TestCommandSessionExportMapsErrorEnvelope(t *testing.T) { } } +// TestWriteSessionListNullsUnsetInstants is the regression guard for the +// session-list bypass: writeSessionList marshals SDK structs directly, so +// without output.NullUnsetInstants an unset archived_at (0 = not archived) +// would leak as the bare integer 0 while a set one renders as an RFC3339 +// string — the mixed-type defect, on both the json envelope and jsonl paths. +func TestWriteSessionListNullsUnsetInstants(t *testing.T) { + const archivedMs = 1779432894000 + sessions := []flashduty.SessionItem{ + {SessionID: "sess-live"}, // archived_at unset + {SessionID: "sess-arch", ArchivedAt: flashduty.TimestampMilli(archivedMs)}, // archived + } + + t.Run("json envelope", func(t *testing.T) { + var buf bytes.Buffer + if err := writeSessionList(&buf, sessionFormatJSON, sessions, 2); err != nil { + t.Fatalf("writeSessionList(json): %v", err) + } + var envelope struct { + Sessions []map[string]any `json:"sessions"` + } + if err := json.Unmarshal(buf.Bytes(), &envelope); err != nil { + t.Fatalf("json output is not valid JSON: %v\n%s", err, buf.String()) + } + if v := envelope.Sessions[0]["archived_at"]; v != nil { + t.Errorf("live session archived_at = %#v, want nil (JSON null)", v) + } + if v, ok := envelope.Sessions[1]["archived_at"].(string); !ok { + t.Errorf("archived session archived_at = %#v, want RFC3339 string", envelope.Sessions[1]["archived_at"]) + } else if _, err := time.Parse(time.RFC3339, v); err != nil { + t.Errorf("archived_at = %q, not RFC3339: %v", v, err) + } + }) + + t.Run("jsonl", func(t *testing.T) { + var buf bytes.Buffer + if err := writeSessionList(&buf, sessionFormatJSONL, sessions, 2); err != nil { + t.Fatalf("writeSessionList(jsonl): %v", err) + } + lines := nonEmptyLines(buf.String()) + if len(lines) != 2 { + t.Fatalf("expected 2 jsonl lines, got %d:\n%s", len(lines), buf.String()) + } + var live map[string]any + if err := json.Unmarshal([]byte(lines[0]), &live); err != nil { + t.Fatalf("line 0 is not valid JSON: %v", err) + } + if v := live["archived_at"]; v != nil { + t.Errorf("live session archived_at = %#v, want nil (JSON null)", v) + } + if strings.Contains(lines[0], `"archived_at":0`) { + t.Errorf("jsonl line leaked the bare integer 0: %s", lines[0]) + } + }) +} + func nonEmptyLines(s string) []string { var out []string for _, l := range strings.Split(s, "\n") { diff --git a/internal/cli/zz_generated_a2a_agents.go b/internal/cli/zz_generated_a2a_agents.go index 85761ec..b39860c 100644 --- a/internal/cli/zz_generated_a2a_agents.go +++ b/internal/cli/zz_generated_a2a_agents.go @@ -37,7 +37,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - can_edit (boolean) (required) — Whether the caller may edit this agent. - card_resolve_timeout (integer) (required) — Card-resolution timeout in seconds. Always 0 today — the API does not yet expose a way to set it. - card_url (string) (required) — URL of the remote agent card. - - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID that created the agent. - environment_id (string) (required) — BYOC runner ID. Set only when 'environment_kind=byoc'; empty otherwise. - environment_kind (string) (required) — Execution environment binding. Empty selects automatic routing; 'byoc' pins the agent to a specific runner named by 'environment_id'. [byoc] @@ -48,7 +48,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - streaming (boolean) (required) — Whether the remote agent supports streaming responses. - task_timeout (integer) (required) — Single-task execution timeout in seconds. Always 0 today — the API does not yet expose a way to set it. - team_id (integer) (required) — Team scope: 0 = account-wide; >0 = the owning team. - - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Args: requireBodyFieldOrExactArg("agent_id", "agent-id"), Example: ` flashduty safari a2a-agent-get --data '{"agent_id":"a2a_6mWqZ2pK9nLcR3tY8uVb4D"}'`, @@ -123,7 +123,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - can_edit (boolean) (required) — Whether the caller may edit this agent. - card_resolve_timeout (integer) (required) — Card-resolution timeout in seconds. Always 0 today — the API does not yet expose a way to set it. - card_url (string) (required) — URL of the remote agent card. - - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID that created the agent. - environment_id (string) (required) — BYOC runner ID. Set only when 'environment_kind=byoc'; empty otherwise. - environment_kind (string) (required) — Execution environment binding. Empty selects automatic routing; 'byoc' pins the agent to a specific runner named by 'environment_id'. [byoc] @@ -134,7 +134,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - streaming (boolean) (required) — Whether the remote agent supports streaming responses. - task_timeout (integer) (required) — Single-task execution timeout in seconds. Always 0 today — the API does not yet expose a way to set it. - team_id (integer) (required) — Team scope: 0 = account-wide; >0 = the owning team. - - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - total (integer) (required) — Total number of matching agents. `, Example: ` flashduty safari a2a-agent-list --data '{"include_account":true,"limit":20,"offset":0}'`, diff --git a/internal/cli/zz_generated_account.go b/internal/cli/zz_generated_account.go index ba4b40e..dee7b81 100644 --- a/internal/cli/zz_generated_account.go +++ b/internal/cli/zz_generated_account.go @@ -20,7 +20,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - account_name (string) — Account name. - avatar (string) — Account avatar URL. - country_code (string) — ISO 3166-1 alpha-2 region code of the contact phone (e.g. "CN", "US", "HK"). - - created_at (string) — Account creation time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Account creation time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - domain (string) — Primary account domain (login subdomain). - email (string) — Account contact email. - extra_domains (array) — Additional account domains. diff --git a/internal/cli/zz_generated_alert_enrichment.go b/internal/cli/zz_generated_alert_enrichment.go index 99d01a7..8341c6b 100644 --- a/internal/cli/zz_generated_alert_enrichment.go +++ b/internal/cli/zz_generated_alert_enrichment.go @@ -24,7 +24,7 @@ Request fields: --integration-id int (required) — Integration ID to query enrichment rules for. Must be greater than 0. (min 1) Response fields ('data' envelope is unwrapped — these fields are at the top level): - - created_at (string) (required) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — Creator member ID. - integration_id (integer) (required) — Integration ID. - rules (array) (required) — Ordered enrichment rules. @@ -46,7 +46,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - source_field (string) — Source field to extract from. Must be 'title', 'description', or a label key prefixed with 'labels.' (e.g. 'labels.env'). - template (string) — Go 'text/template' string. Alert fields are available as '{{.title}}', '{{.description}}', and '{{.labels.key}}'. Example: '{{.labels.region}}-{{.labels.env}}'. (≤500 chars) - status (string) (required) — Rule set status. - - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Last updater member ID. `, Args: requireBodyFieldOrExactArg("integration_id", "integration-id"), @@ -99,7 +99,7 @@ Request fields: Response fields ('data' envelope is unwrapped — rows are nested under items[]; pipe 'jq '.items[]'', NOT '.data.items[]'): - items (array) (required) — Enrichment rule sets. - - created_at (string) (required) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — Creator member ID. - integration_id (integer) (required) — Integration ID. - rules (array) (required) — Ordered enrichment rules. @@ -121,7 +121,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - source_field (string) — Source field to extract from. Must be 'title', 'description', or a label key prefixed with 'labels.' (e.g. 'labels.env'). - template (string) — Go 'text/template' string. Alert fields are available as '{{.title}}', '{{.description}}', and '{{.labels.key}}'. Example: '{{.labels.region}}-{{.labels.env}}'. (≤500 chars) - status (string) (required) — Rule set status. - - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Last updater member ID. `, Args: requireBodyFieldOrArgs("integration_ids", "integration-ids"), @@ -244,10 +244,10 @@ Request fields: Response fields ('data' envelope is unwrapped — these fields are at the top level): - account_id (integer) (required) — Owning account ID. - - created_at (string) (required) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — Creator member ID. - default_value (any) — Default value. Type depends on 'field_type': 'bool' for checkbox; 'string' for single_select/text; 'string[]' for multi_select; may be 'null' if no default. - - deleted_at (string) — Deletion timestamp, Unix seconds. Only present for soft-deleted fields. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Deletion timestamp, Unix seconds. Only present for soft-deleted fields. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) — Optional free-text description. (≤499 chars) - display_name (string) (required) — Human-readable name shown in the UI. (≤39 chars) - field_id (string) (required) — Field ID — 24-character hex ObjectID. @@ -255,7 +255,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - field_type (string) (required) — Field type. | Value | Meaning | |---|---| | 'checkbox' | Checkbox; value is a bool, options are not supported. | | 'multi_select' | Multi-select; value is a string array, each element must be one of options. | | 'single_select' | Single-select; value is a string from options. | | 'text' | Free text; value is a string. | [checkbox, multi_select, single_select, text] - options (any) — Allowed choices for 'single_select'/'multi_select' (non-empty unique string array). 'null' or empty for 'checkbox'/'text'. - status (string) (required) — Field status (e.g. 'enabled', 'deleted'). - - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Last updater member ID. - value_type (string) (required) — Value type. 'checkbox' is always 'bool'; 'single_select'/'multi_select'/'text' are always 'string'. 'float' is reserved and never occurs today. [string, bool, float] `, @@ -316,10 +316,10 @@ Request fields: Response fields ('data' envelope is unwrapped — rows are nested under items[]; pipe 'jq '.items[]'', NOT '.data.items[]'): - items (array) (required) — All non-deleted custom fields for the account. No pagination. - account_id (integer) (required) — Owning account ID. - - created_at (string) (required) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — Creator member ID. - default_value (any) — Default value. Type depends on 'field_type': 'bool' for checkbox; 'string' for single_select/text; 'string[]' for multi_select; may be 'null' if no default. - - deleted_at (string) — Deletion timestamp, Unix seconds. Only present for soft-deleted fields. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Deletion timestamp, Unix seconds. Only present for soft-deleted fields. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) — Optional free-text description. (≤499 chars) - display_name (string) (required) — Human-readable name shown in the UI. (≤39 chars) - field_id (string) (required) — Field ID — 24-character hex ObjectID. @@ -327,7 +327,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - field_type (string) (required) — Field type. | Value | Meaning | |---|---| | 'checkbox' | Checkbox; value is a bool, options are not supported. | | 'multi_select' | Multi-select; value is a string array, each element must be one of options. | | 'single_select' | Single-select; value is a string from options. | | 'text' | Free text; value is a string. | [checkbox, multi_select, single_select, text] - options (any) — Allowed choices for 'single_select'/'multi_select' (non-empty unique string array). 'null' or empty for 'checkbox'/'text'. - status (string) (required) — Field status (e.g. 'enabled', 'deleted'). - - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Last updater member ID. - value_type (string) (required) — Value type. 'checkbox' is always 'bool'; 'single_select'/'multi_select'/'text' are always 'string'. 'float' is reserved and never occurs today. [string, bool, float] `, @@ -592,7 +592,7 @@ Request fields: Response fields ('data' envelope is unwrapped — these fields are at the top level): - api_id (string) (required) — API ID (MongoDB ObjectID hex). - api_name (string) (required) — API name. - - created_at (string) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — Creator member ID. - description (string) (required) — Description. - headers (object) (required) — Custom request headers. @@ -601,7 +601,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - status (string) (required) — API status. - team_id (integer) (required) — Owning team ID. - timeout (integer) (required) — Request timeout in seconds. - - updated_at (string) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Last updater member ID. - url (string) (required) — Endpoint URL. `, @@ -653,7 +653,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - items (array) (required) — Mapping APIs. - api_id (string) (required) — API ID (MongoDB ObjectID hex). - api_name (string) (required) — API name. - - created_at (string) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — Creator member ID. - description (string) (required) — Description. - headers (object) (required) — Custom request headers. @@ -662,7 +662,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - status (string) (required) — API status. - team_id (integer) (required) — Owning team ID. - timeout (integer) (required) — Request timeout in seconds. - - updated_at (string) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Last updater member ID. - url (string) (required) — Endpoint URL. - total (integer) (required) — Total API count. @@ -998,10 +998,10 @@ Request fields: Response fields ('data' envelope is unwrapped — rows are nested under items[]; pipe 'jq '.items[]'', NOT '.data.items[]'): - has_next_page (boolean) (required) — Whether more pages exist. - items (array) (required) — Data rows. - - created_at (string) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - fields (object) — All label key-value pairs for this row. - key (string) — Composite key derived from source label values. - - updated_at (string) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - search_after_ctx (string) — Cursor token for the next page. - total (integer) (required) — Total matching rows. `, @@ -1290,7 +1290,7 @@ Request fields: --schema-id string (required) — Mapping schema ID (MongoDB ObjectID hex). Response fields ('data' envelope is unwrapped — these fields are at the top level): - - created_at (string) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — Creator member ID. - description (string) (required) — Schema description. - result_labels (array) (required) — Output label names. @@ -1299,7 +1299,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - source_labels (array) (required) — Lookup key label names. - status (string) (required) — Schema status. - team_id (integer) (required) — Owning team ID. - - updated_at (string) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Last updater member ID. `, Args: requireBodyFieldOrExactArg("schema_id", "schema-id"), @@ -1348,7 +1348,7 @@ API: POST /enrichment/mapping/schema/list (mapping-schema-read-list) Response fields ('data' envelope is unwrapped — rows are nested under items[]; pipe 'jq '.items[]'', NOT '.data.items[]'): - items (array) (required) — Mapping schemas. - - created_at (string) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — Creator member ID. - description (string) (required) — Schema description. - result_labels (array) (required) — Output label names. @@ -1357,7 +1357,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - source_labels (array) (required) — Lookup key label names. - status (string) (required) — Schema status. - team_id (integer) (required) — Owning team ID. - - updated_at (string) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update timestamp, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Last updater member ID. - total (integer) (required) — Total schema count. `, diff --git a/internal/cli/zz_generated_alert_rules.go b/internal/cli/zz_generated_alert_rules.go index c870192..38ea836 100644 --- a/internal/cli/zz_generated_alert_rules.go +++ b/internal/cli/zz_generated_alert_rules.go @@ -28,7 +28,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - action (string) (required) — Action performed, e.g. 'create', 'update'. - alert_rule_id (integer) (required) — ID of the alert rule this record belongs to. - content (string) — JSON string of the full rule snapshot at audit time. Populated on '/monit/rule/audit/detail', omitted on list responses. - - created_at (string) (required) — When this audit record was produced, as a Unix timestamp in seconds; equals the rule's 'updated_at' at change time. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — When this audit record was produced, as a Unix timestamp in seconds; equals the rule's 'updated_at' at change time. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — ID of the user who made this change (taken from the rule's 'updater_id' at change time). - creator_name (string) (required) — Name of the user who made this change (taken from the rule's 'updater_name' at change time). - id (integer) (required) — Audit record ID. @@ -82,7 +82,7 @@ Response fields ('data' is a TOP-LEVEL array of these row objects — pipe 'jq ' - action (string) (required) — Action performed, e.g. 'create', 'update'. - alert_rule_id (integer) (required) — ID of the alert rule this record belongs to. - content (string) — JSON string of the full rule snapshot at audit time. Populated on '/monit/rule/audit/detail', omitted on list responses. - - created_at (string) (required) — When this audit record was produced, as a Unix timestamp in seconds; equals the rule's 'updated_at' at change time. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — When this audit record was produced, as a Unix timestamp in seconds; equals the rule's 'updated_at' at change time. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — ID of the user who made this change (taken from the rule's 'updater_id' at change time). - creator_name (string) (required) — Name of the user who made this change (taken from the rule's 'updater_name' at change time). - id (integer) (required) — Audit record ID. @@ -234,7 +234,7 @@ API: POST /monit/rule/counter/total (monit-rule-read-counter-total) Response fields ('data' is a TOP-LEVEL array of these row objects — pipe 'jq '.[]'', NOT '.items[]'): - account_id (integer) (required) — ID of the account this snapshot belongs to. - - clock (string) (required) — Sample timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - clock (string) (required) — Sample timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - id (integer) (required) — ID of this snapshot record. - num (integer) (required) — Rule count at the sample time. `, @@ -425,7 +425,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - account_id (integer) (required) — Account ID. Filled by the server from the authenticated identity; do not provide. - annotations (object) — Annotation key-value pairs delivered with alert events; keys must not start with '$' (reserved for query fields). - channel_ids (array) — Channel IDs to send alerts to. - - created_at (string) (required) — Creation time as a Unix timestamp in seconds. Generated by the server; do not provide. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation time as a Unix timestamp in seconds. Generated by the server; do not provide. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — Creator user ID. Filled by the server from the current user; do not provide. - creator_name (string) (required) — Creator name. Filled by the server; do not provide. - cron_pattern (string) (required) — Schedule expression: a 6-field cron (with seconds) or an '@every 30s' interval descriptor. Must not start with 'CRON_TZ=' or 'TZ='; use the 'timezone' field instead. @@ -489,7 +489,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - expr (string) — Query expression. - name (string) — Relate-query identifier. - timezone (string) — Timezone in which the rule executes. Determines how the cron schedule and effective time windows are interpreted. Only IANA timezone names are accepted (e.g. 'Asia/Shanghai', 'UTC', 'Europe/London'); shortcuts and offsets such as 'Local', 'UTC+8', or 'CST' are rejected. Treated as 'Asia/Shanghai' if empty. - - updated_at (string) (required) — Last update time as a Unix timestamp in seconds. Generated by the server; do not provide. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update time as a Unix timestamp in seconds. Generated by the server; do not provide. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updater_id (integer) (required) — Last updater user ID. Filled by the server; do not provide. - updater_name (string) (required) — Last updater name. Filled by the server; do not provide. `, @@ -539,7 +539,7 @@ Request fields: Response fields ('data' is a TOP-LEVEL array of these row objects — pipe 'jq '.[]'', NOT '.items[]'): - account_id (integer) (required) — Account ID. - - created_at (string) (required) — Creation time, as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation time, as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — ID of the user who created the rule. - creator_name (string) (required) — Name of the user who created the rule. - cron_pattern (string) (required) — 5-field cron schedule, e.g. '* * * * *'. Must not start with 'CRON_TZ=' or 'TZ='; use the 'timezone' field instead. @@ -553,7 +553,7 @@ Response fields ('data' is a TOP-LEVEL array of these row objects — pipe 'jq ' - name (string) (required) — Rule name. - timezone (string) — Timezone in which the rule executes. Determines how the cron schedule and effective time windows are interpreted. Only IANA timezone names are accepted (e.g. 'Asia/Shanghai', 'UTC', 'Europe/London'); shortcuts and offsets such as 'Local', 'UTC+8', or 'CST' are rejected. Treated as 'Asia/Shanghai' if empty. - triggered (boolean) (required) — True if the rule currently has active alerts. - - updated_at (string) (required) — Last modification time, as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last modification time, as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updater_id (integer) (required) — ID of the user who last modified the rule. - updater_name (string) (required) — Name of the user who last modified the rule. `, diff --git a/internal/cli/zz_generated_alerts.go b/internal/cli/zz_generated_alerts.go index b7429a8..38b8560 100644 --- a/internal/cli/zz_generated_alerts.go +++ b/internal/cli/zz_generated_alerts.go @@ -52,14 +52,14 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - alert_id (string) — Parent alert ID (MongoDB ObjectID). - alert_key (string) — Deduplication key used to merge events into an alert. - channel_id (integer) — Channel ID the event is routed to. - - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) — Deprecated. Use 'integration_id' instead. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) — Event description. - event_id (string) — Event ID (MongoDB ObjectID). - event_severity (string) — Severity of this event. [Critical, Warning, Info, Ok] - event_status (string) — Status of this event. [Critical, Warning, Info, Ok] - - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - images (array) — Images attached to the event. - alt (string) — Alt text. - href (string) — Optional link URL when the image is clicked. @@ -69,7 +69,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - labels (object) — Label key-value pairs. - title (string) — Event title. - title_rule (string) — Title template used to derive 'title' from labels. - - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - search_after_ctx (string) — Cursor for the next page — the ObjectID of the last event on this page; pass it back as 'search_after_ctx'. Omitted when there are no more results or the result is empty. - total (integer) — Total number of matching events, capped at 1000. `, @@ -182,14 +182,14 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - alert_id (string) — Parent alert ID (MongoDB ObjectID). - alert_key (string) — Deduplication key used to merge events into an alert. - channel_id (integer) — Channel ID the event is routed to. - - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) — Deprecated. Use 'integration_id' instead. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) — Event description. - event_id (string) — Event ID (MongoDB ObjectID). - event_severity (string) — Severity of this event. [Critical, Warning, Info, Ok] - event_status (string) — Status of this event. [Critical, Warning, Info, Ok] - - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - images (array) — Images attached to the event. - alt (string) — Alt text. - href (string) — Optional link URL when the image is clicked. @@ -199,7 +199,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - labels (object) — Label key-value pairs. - title (string) — Event title. - title_rule (string) — Title template used to derive 'title' from labels. - - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - search_after_ctx (string) — Cursor to pass as 'search_after_ctx' for the next page. - total (integer) (required) — Total matching event count. `, @@ -281,7 +281,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - has_next_page (boolean) — Whether a next page exists. - items (array) — Alert feed records on the current page. - account_id (integer) (required) — Account ID. - - created_at (string) (required) — Creation timestamp in Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp in Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — Member ID of the creator. 0 for system-generated entries. - detail (object) (required) — Type-specific payload. The concrete shape is determined by 'type'. - comment (string) — Comment body. @@ -289,7 +289,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - status (string) — Severity level. [Ok, Critical, Warning, Info] - ref_id (string) (required) — ObjectID of the alert this entry references. - type (string) (required) — Alert activity feed entry type. Each value identifies one alert lifecycle event; the matching 'detail' payload shape is determined by this field. | Type | Meaning | |---|---| | 'a_new' | Alert triggered. | | 'a_update' | Alert updated by an incoming event (e.g. severity or status change). | | 'a_merge' | Alert merged. | | 'a_comm' | Comment added on the alert. | | 'a_m_silence' | Alert muted by a silence rule. | | 'a_m_inhibit' | Alert muted by an inhibit rule. | | 'a_close' | Alert closed (historical data only; no longer produced). | [a_new, a_update, a_merge, a_comm, a_m_silence, a_m_inhibit, a_close] - - updated_at (string) (required) — Last update timestamp in Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp in Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Args: requireBodyFieldOrExactArg("alert_id", "alert-id"), Example: ` flashduty alert feed --data '{"alert_id":"663a1b2c3d4e5f6789abcdef","asc":false,"limit":20}'`, @@ -368,27 +368,27 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - channel_id (integer) — ID of the channel the alert belongs to. - channel_name (string) — Display name of the channel. - channel_status (string) — Status of the channel (e.g. 'enabled', 'disabled'). - - created_at (string) — Creation timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) — Deprecated. Use 'integration_id' instead. Deprecated: use 'integration_id' instead. - data_source_name (string) — Deprecated. Use 'integration_name' instead. - data_source_ref_id (string) — Deprecated. Use 'integration_ref_id' instead. - data_source_type (string) — Deprecated. Use 'integration_type' instead. - description (string) — Alert description. - - end_time (string) — Resolution time, Unix epoch seconds. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - end_time (string) — Resolution time, Unix epoch seconds. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - event_cnt (integer) — Total number of raw events received by this alert. - events (array) — Recent raw events attached to this alert. Populated only by some endpoints. - account_id (integer) — Account ID. - alert_id (string) — Parent alert ID (MongoDB ObjectID). - alert_key (string) — Deduplication key used to merge events into an alert. - channel_id (integer) — Channel ID the event is routed to. - - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) — Deprecated. Use 'integration_id' instead. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) — Event description. - event_id (string) — Event ID (MongoDB ObjectID). - event_severity (string) — Severity of this event. [Critical, Warning, Info, Ok] - event_status (string) — Status of this event. [Critical, Warning, Info, Ok] - - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - images (array) — Images attached to the event. - alt (string) — Alt text. - href (string) — Optional link URL when the image is clicked. @@ -398,7 +398,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - labels (object) — Label key-value pairs. - title (string) — Event title. - title_rule (string) — Title template used to derive 'title' from labels. - - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - ever_muted (boolean) — True if this alert has ever been silenced. - images (array) — Images attached to the alert. - alt (string) — Alt text. @@ -413,13 +413,13 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - integration_ref_id (string) — External reference ID of the integration. - integration_type (string) — Type/plugin key of the integration. - labels (object) — Label key-value pairs. - - last_time (string) — Last-event time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_time (string) — Last-event time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - responder_email (string) — Email of the current responder (from the associated incident). - responder_name (string) — Display name of the current responder (from the associated incident). - - start_time (string) — First-seen time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - start_time (string) — First-seen time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - title (string) — Alert title. - title_rule (string) — Title template used to derive 'title' from the event labels (e.g. '$service::$cluster'). - - updated_at (string) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Args: requireBodyFieldOrExactArg("alert_id", "alert-id"), Example: ` flashduty alert info --data '{"alert_id":"663a1b2c3d4e5f6789abcdef"}'`, @@ -510,27 +510,27 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - channel_id (integer) — ID of the channel the alert belongs to. - channel_name (string) — Display name of the channel. - channel_status (string) — Status of the channel (e.g. 'enabled', 'disabled'). - - created_at (string) — Creation timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) — Deprecated. Use 'integration_id' instead. Deprecated: use 'integration_id' instead. - data_source_name (string) — Deprecated. Use 'integration_name' instead. - data_source_ref_id (string) — Deprecated. Use 'integration_ref_id' instead. - data_source_type (string) — Deprecated. Use 'integration_type' instead. - description (string) — Alert description. - - end_time (string) — Resolution time, Unix epoch seconds. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - end_time (string) — Resolution time, Unix epoch seconds. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - event_cnt (integer) — Total number of raw events received by this alert. - events (array) — Recent raw events attached to this alert. Populated only by some endpoints. - account_id (integer) — Account ID. - alert_id (string) — Parent alert ID (MongoDB ObjectID). - alert_key (string) — Deduplication key used to merge events into an alert. - channel_id (integer) — Channel ID the event is routed to. - - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) — Deprecated. Use 'integration_id' instead. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) — Event description. - event_id (string) — Event ID (MongoDB ObjectID). - event_severity (string) — Severity of this event. [Critical, Warning, Info, Ok] - event_status (string) — Status of this event. [Critical, Warning, Info, Ok] - - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - images (array) — Images attached to the event. - alt (string) — Alt text. - href (string) — Optional link URL when the image is clicked. @@ -540,7 +540,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - labels (object) — Label key-value pairs. - title (string) — Event title. - title_rule (string) — Title template used to derive 'title' from labels. - - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - ever_muted (boolean) — True if this alert has ever been silenced. - images (array) — Images attached to the alert. - alt (string) — Alt text. @@ -555,13 +555,13 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - integration_ref_id (string) — External reference ID of the integration. - integration_type (string) — Type/plugin key of the integration. - labels (object) — Label key-value pairs. - - last_time (string) — Last-event time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_time (string) — Last-event time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - responder_email (string) — Email of the current responder (from the associated incident). - responder_name (string) — Display name of the current responder (from the associated incident). - - start_time (string) — First-seen time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - start_time (string) — First-seen time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - title (string) — Alert title. - title_rule (string) — Title template used to derive 'title' from the event labels (e.g. '$service::$cluster'). - - updated_at (string) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - search_after_ctx (string) — Cursor for the next page. - total (integer) — Total matching alerts. `, @@ -686,27 +686,27 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - channel_id (integer) — ID of the channel the alert belongs to. - channel_name (string) — Display name of the channel. - channel_status (string) — Status of the channel (e.g. 'enabled', 'disabled'). - - created_at (string) — Creation timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) — Deprecated. Use 'integration_id' instead. Deprecated: use 'integration_id' instead. - data_source_name (string) — Deprecated. Use 'integration_name' instead. - data_source_ref_id (string) — Deprecated. Use 'integration_ref_id' instead. - data_source_type (string) — Deprecated. Use 'integration_type' instead. - description (string) — Alert description. - - end_time (string) — Resolution time, Unix epoch seconds. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - end_time (string) — Resolution time, Unix epoch seconds. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - event_cnt (integer) — Total number of raw events received by this alert. - events (array) — Recent raw events attached to this alert. Populated only by some endpoints. - account_id (integer) — Account ID. - alert_id (string) — Parent alert ID (MongoDB ObjectID). - alert_key (string) — Deduplication key used to merge events into an alert. - channel_id (integer) — Channel ID the event is routed to. - - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) — Deprecated. Use 'integration_id' instead. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) — Event description. - event_id (string) — Event ID (MongoDB ObjectID). - event_severity (string) — Severity of this event. [Critical, Warning, Info, Ok] - event_status (string) — Status of this event. [Critical, Warning, Info, Ok] - - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - images (array) — Images attached to the event. - alt (string) — Alt text. - href (string) — Optional link URL when the image is clicked. @@ -716,7 +716,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - labels (object) — Label key-value pairs. - title (string) — Event title. - title_rule (string) — Title template used to derive 'title' from labels. - - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - ever_muted (boolean) — True if this alert has ever been silenced. - images (array) — Images attached to the alert. - alt (string) — Alt text. @@ -731,13 +731,13 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - integration_ref_id (string) — External reference ID of the integration. - integration_type (string) — Type/plugin key of the integration. - labels (object) — Label key-value pairs. - - last_time (string) — Last-event time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_time (string) — Last-event time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - responder_email (string) — Email of the current responder (from the associated incident). - responder_name (string) — Display name of the current responder (from the associated incident). - - start_time (string) — First-seen time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - start_time (string) — First-seen time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - title (string) — Alert title. - title_rule (string) — Title template used to derive 'title' from the event labels (e.g. '$service::$cluster'). - - updated_at (string) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - search_after_ctx (string) — Cursor for the next page. - total (integer) — Total matching alerts. `, @@ -790,7 +790,7 @@ Request fields: --integration-id int (required) — Integration ID. Response fields ('data' envelope is unwrapped — these fields are at the top level): - - created_at (string) — Creation timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) — Member ID who created the pipeline. - integration_id (integer) — Integration ID this pipeline applies to. - rules (array) — Ordered list of processing rules. @@ -809,7 +809,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - vals (array) (required) — List of values to match against. Each entry is a plain string or a '/regex/' pattern. - title (string) — New title template. Supports Golang template syntax referencing alert fields. - status (string) — Pipeline status. Possible values: 'enabled', 'disabled'. - - updated_at (string) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) — Member ID who last updated the pipeline. `, Args: requireBodyFieldOrExactArg("integration_id", "integration-id"), @@ -862,7 +862,7 @@ Request fields: Response fields ('data' envelope is unwrapped — rows are nested under items[]; pipe 'jq '.items[]'', NOT '.data.items[]'): - items (array) — Alert pipeline configuration of each requested integration, one item per configured integration. - - created_at (string) — Creation timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) — Member ID who created the pipeline. - integration_id (integer) — Integration ID this pipeline applies to. - rules (array) — Ordered list of processing rules. @@ -878,7 +878,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - source_filters (array>) — Filter that identifies the source alerts to inhibit. - title (string) — New title template. Supports Golang template syntax referencing alert fields. - status (string) — Pipeline status. Possible values: 'enabled', 'disabled'. - - updated_at (string) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) — Member ID who last updated the pipeline. `, Args: requireBodyFieldOrArgs("integration_ids", "integration-ids"), diff --git a/internal/cli/zz_generated_analytics.go b/internal/cli/zz_generated_analytics.go index 7ba3216..8bb12b9 100644 --- a/internal/cli/zz_generated_analytics.go +++ b/internal/cli/zz_generated_analytics.go @@ -97,7 +97,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - total_notifications (integer) — Total number of notifications sent. - total_seconds_to_ack (integer) — Total time to first acknowledgement in seconds. - total_seconds_to_close (integer) — Total time to close in seconds. - - ts (string) — Aggregation bucket start time, Unix seconds. Present when 'aggregate_unit' is used. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - ts (string) — Aggregation bucket start time, Unix seconds. Present when 'aggregate_unit' is used. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Example: ` flashduty insight account --data '{"aggregate_unit":"day","end_time":1712604800,"severities":["Critical","Warning"],"start_time":1712000000}'`, RunE: func(cmd *cobra.Command, args []string) error { @@ -307,7 +307,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - total_notifications (integer) — Total number of notifications sent. - total_seconds_to_ack (integer) — Total time to first acknowledgement in seconds. - total_seconds_to_close (integer) — Total time to close in seconds. - - ts (string) — Aggregation bucket start time, Unix seconds. Present when 'aggregate_unit' is used. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - ts (string) — Aggregation bucket start time, Unix seconds. Present when 'aggregate_unit' is used. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Example: ` flashduty insight channel --data '{"aggregate_unit":"day","channel_ids":[4321322010131],"end_time":1712604800,"start_time":1712000000}'`, RunE: func(cmd *cobra.Command, args []string) error { @@ -508,7 +508,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - total_interruptions (integer) — Interruptions for this responder: notifications sent via app push, SMS, or voice call; consecutive notifications within 60 seconds count as one. - total_notifications (integer) — Total notifications sent to this responder. - total_seconds_to_ack (integer) — This responder's total time to acknowledgement in seconds: each incident contributes acknowledgement time minus assignment time. - - ts (string) — Aggregation bucket start time, Unix seconds. Present when 'aggregate_unit' is used. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - ts (string) — Aggregation bucket start time, Unix seconds. Present when 'aggregate_unit' is used. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Example: ` flashduty insight responder --data '{"aggregate_unit":"day","end_time":1712604800,"responder_ids":[3790925372131],"start_time":1712000000}'`, RunE: func(cmd *cobra.Command, args []string) error { @@ -718,7 +718,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - total_notifications (integer) — Total number of notifications sent. - total_seconds_to_ack (integer) — Total time to first acknowledgement in seconds. - total_seconds_to_close (integer) — Total time to close in seconds. - - ts (string) — Aggregation bucket start time, Unix seconds. Present when 'aggregate_unit' is used. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - ts (string) — Aggregation bucket start time, Unix seconds. Present when 'aggregate_unit' is used. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Example: ` flashduty insight team --data '{"aggregate_unit":"day","end_time":1712604800,"start_time":1712000000,"team_ids":[4295771902131]}'`, RunE: func(cmd *cobra.Command, args []string) error { @@ -1248,7 +1248,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - alert_cnt (integer) — Total number of alerts aggregated into the incident. - alert_event_cnt (integer) — Total number of alert events associated with the incident; each report of an alert counts as one event. - assigned_to (object) — Current assignment target for the incident. - - assigned_at (string) — Unix timestamp (seconds) when this assignment was made. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - assigned_at (string) — Unix timestamp (seconds) when this assignment was made. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - escalate_rule_id (string) — Escalation rule ID (MongoDB ObjectID) driving the assignment. - escalate_rule_name (string) — Display name of the escalation rule. - id (string) — Internal assignment record ID. @@ -1261,7 +1261,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - closed_by (string) — How the incident was closed: 'auto', 'timeout', or 'manually'. Empty string while the incident is still open. [auto, timeout, manually] - closer_id (integer) — Member ID of the person who closed the incident. - closer_name (string) — Display name of the person who closed the incident. - - created_at (string) — Incident creation time, as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Incident creation time, as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) — Person ID of the incident creator. - creator_name (string) — Display name of the incident creator. - description (string) — Incident description. Omitted when empty. @@ -1281,16 +1281,16 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - progress (string) — Incident progress state — one of 'Triggered', 'Processing', 'Closed'. - reassignments (integer) — Number of reassignments. - responders (array) — Responders with per-person assignment and acknowledgement times. - - acknowledged_at (string) — Acknowledgement time, as a Unix timestamp in seconds; 0 if not acknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - acknowledged_at (string) — Acknowledgement time, as a Unix timestamp in seconds; 0 if not acknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - as (string) — Responder's identity in an external chat tool (e.g. Slack); only present when backfilled by an external system. - - assigned_at (string) — Assignment time, as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - assigned_at (string) — Assignment time, as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - email (string) — Responder email. Omitted when empty. - person_id (integer) — Person ID of the responder. - person_name (string) — Responder display name. Omitted when empty. - seconds_to_ack (integer) — Seconds from incident creation to the first acknowledgement; 0 if never acknowledged. - seconds_to_close (integer) — Seconds from incident creation to close; 0 if not closed. - severity (string) — Incident severity. [Critical, Warning, Info] - - snoozed_before (string) — Unix timestamp in seconds until which the incident is snoozed. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - snoozed_before (string) — Unix timestamp in seconds until which the incident is snoozed. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - team_id (integer) — ID of the team that owns the incident. - team_name (string) — Name of the team that owns the incident. - timeout_escalations (integer) — Escalations triggered by timeout. diff --git a/internal/cli/zz_generated_applications.go b/internal/cli/zz_generated_applications.go index a947772..349d3f6 100644 --- a/internal/cli/zz_generated_applications.go +++ b/internal/cli/zz_generated_applications.go @@ -32,7 +32,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - application_id (string) — Unique application ID. - application_name (string) — Application display name. - client_token (string) — Token used to initialize the RUM SDK. - - created_at (string) — Creation timestamp, Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation timestamp, Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) — Creator member ID. - is_private (boolean) — If 'true', the application is only accessible to team members. - links (object) — External link integration settings for the application. @@ -47,7 +47,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - endpoint (string) — Trace endpoint URL (http or https). - open_type (string) — How to open the trace link. One of 'popup' (open trace details in a popup) or 'tab' (open in a new browser tab). [popup, tab] - type (string) — Application type. Platform identifier, one of 'browser' (web), 'ios', 'android', 'react-native', 'flutter', 'kotlin-multiplatform', 'roku', 'unity'. Note: the create API also accepts 'miniprogram', 'harmony', and 'electron', and applications of those types appear in responses too (see Enum gaps). [browser, ios, android, react-native, flutter, kotlin-multiplatform, roku, unity, miniprogram, harmony, electron] - - updated_at (string) — Last update timestamp, Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update timestamp, Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) — Last updater member ID. `, Args: requireBodyFieldOrExactArg("application_id", "application-id"), @@ -108,7 +108,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - application_id (string) — Unique application ID. - application_name (string) — Application display name. - client_token (string) — Token used to initialize the RUM SDK. - - created_at (string) — Creation timestamp, Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation timestamp, Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) — Creator member ID. - is_private (boolean) — If 'true', the application is only accessible to team members. - links (object) — External link integration settings for the application. @@ -123,7 +123,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - endpoint (string) — Trace endpoint URL (http or https). - open_type (string) — How to open the trace link. One of 'popup' (open trace details in a popup) or 'tab' (open in a new browser tab). [popup, tab] - type (string) — Application type. Platform identifier, one of 'browser' (web), 'ios', 'android', 'react-native', 'flutter', 'kotlin-multiplatform', 'roku', 'unity'. Note: the create API also accepts 'miniprogram', 'harmony', and 'electron', and applications of those types appear in responses too (see Enum gaps). [browser, ios, android, react-native, flutter, kotlin-multiplatform, roku, unity, miniprogram, harmony, electron] - - updated_at (string) — Last update timestamp, Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update timestamp, Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) — Last updater member ID. `, Args: requireBodyFieldOrArgs("application_ids", "application-ids"), @@ -199,7 +199,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - application_id (string) — Unique application ID. - application_name (string) — Application display name. - client_token (string) — Token used to initialize the RUM SDK. - - created_at (string) — Creation timestamp, Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation timestamp, Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) — Creator member ID. - is_private (boolean) — If 'true', the application is only accessible to team members. - links (object) — External link integration settings for the application. @@ -214,7 +214,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - endpoint (string) — Trace endpoint URL (http or https). - open_type (string) — How to open the trace link. One of 'popup' (open trace details in a popup) or 'tab' (open in a new browser tab). [popup, tab] - type (string) — Application type. Platform identifier, one of 'browser' (web), 'ios', 'android', 'react-native', 'flutter', 'kotlin-multiplatform', 'roku', 'unity'. Note: the create API also accepts 'miniprogram', 'harmony', and 'electron', and applications of those types appear in responses too (see Enum gaps). [browser, ios, android, react-native, flutter, kotlin-multiplatform, roku, unity, miniprogram, harmony, electron] - - updated_at (string) — Last update timestamp, Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update timestamp, Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) — Last updater member ID. - total (integer) — Total number of applications matching the filter conditions. `, diff --git a/internal/cli/zz_generated_audit_logs.go b/internal/cli/zz_generated_audit_logs.go index 00f70c0..2e42842 100644 --- a/internal/cli/zz_generated_audit_logs.go +++ b/internal/cli/zz_generated_audit_logs.go @@ -83,7 +83,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - docs (array) — Audit log entries for this page. - account_id (integer) (required) — ID of the account. - body (string) (required) — JSON-encoded request body (may be truncated at 10 KB). - - created_at (string) (required) — Timestamp of the operation in Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Timestamp of the operation in Unix epoch milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - ip (string) (required) — Client IP address of the caller. - is_dangerous (boolean) (required) — True if this is flagged as a high-risk operation. - is_write (boolean) (required) — True for mutating operations; false for read-only ones. diff --git a/internal/cli/zz_generated_automations.go b/internal/cli/zz_generated_automations.go index 8f80d56..b83bc11 100644 --- a/internal/cli/zz_generated_automations.go +++ b/internal/cli/zz_generated_automations.go @@ -26,7 +26,7 @@ Request fields: Response fields ('data' envelope is unwrapped — these fields are at the top level): - account_id (integer) (required) — Account ID. - can_edit (boolean) (required) — True when the caller can manage this rule: the personal rule owner; for team rules, an account admin or a member of the rule's team. - - created_at (string) (required) — Creation time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - cron_expr (string) (required) — Normalized 5-field cron expression. - enabled (boolean) (required) — Whether the rule is enabled. - environment_id (string) (required) — BYOC Runner ID. @@ -44,12 +44,12 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - prompt (string) (required) — Task prompt. - rule_id (string) (required) — Rule ID. - run_scope (string) (required) — Hidden session run scope. One of: 'person' (personal rule, team_id=0, runs as the creator; disabled when the creator leaves the account), 'team' (team rule, team_id>0, owned by the team and shared with its members; survives the creator leaving). Derived from the rule's team_id. [person, team] - - schedule_next_fire_at_ms (string) (required) — Next scheduled fire time, Unix milliseconds. 0 means no future scheduled fire is available. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - schedule_next_fire_at_ms (string) (required) — Next scheduled fire time, Unix milliseconds. 0 means no future scheduled fire is available. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - schedule_trigger_enabled (boolean) (required) — Whether the schedule trigger is enabled. - schedule_trigger_id (string) — Schedule trigger ID. - team_id (integer) (required) — Scope team ID; 0 means personal rule. - timezone (string) (required) — IANA timezone 'cron_expr' is evaluated in. Always populated for rules created after this field shipped; empty on legacy rows created before it, which still resolve to UTC when scheduled. - - updated_at (string) (required) — Last update time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Args: requireBodyFieldOrExactArg("rule_id", "rule-id"), Example: ` flashduty safari automation-rule-get --data '{"rule_id":"arule_7NnLzY2Qp8xS4kUaV3mR6b"}'`, @@ -117,7 +117,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - rules (array) (required) — Array of automation rules for the current page, used with 'total' for pagination. - account_id (integer) (required) — Account ID. - can_edit (boolean) (required) — True when the caller can manage this rule: the personal rule owner; for team rules, an account admin or a member of the rule's team. - - created_at (string) (required) — Creation time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - cron_expr (string) (required) — Normalized 5-field cron expression. - enabled (boolean) (required) — Whether the rule is enabled. - environment_id (string) (required) — BYOC Runner ID. @@ -135,12 +135,12 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - prompt (string) (required) — Task prompt. - rule_id (string) (required) — Rule ID. - run_scope (string) (required) — Hidden session run scope. One of: 'person' (personal rule, team_id=0, runs as the creator; disabled when the creator leaves the account), 'team' (team rule, team_id>0, owned by the team and shared with its members; survives the creator leaving). Derived from the rule's team_id. [person, team] - - schedule_next_fire_at_ms (string) (required) — Next scheduled fire time, Unix milliseconds. 0 means no future scheduled fire is available. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - schedule_next_fire_at_ms (string) (required) — Next scheduled fire time, Unix milliseconds. 0 means no future scheduled fire is available. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - schedule_trigger_enabled (boolean) (required) — Whether the schedule trigger is enabled. - schedule_trigger_id (string) — Schedule trigger ID. - team_id (integer) (required) — Scope team ID; 0 means personal rule. - timezone (string) (required) — IANA timezone 'cron_expr' is evaluated in. Always populated for rules created after this field shipped; empty on legacy rows created before it, which still resolve to UTC when scheduled. - - updated_at (string) (required) — Last update time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - total (integer) (required) — Total count. `, Example: ` flashduty safari automation-rule-list --data '{"limit":20,"scope":"all"}'`, @@ -242,7 +242,7 @@ Request fields: Response fields ('data' envelope is unwrapped — these fields are at the top level): - account_id (integer) (required) — Account ID. - can_edit (boolean) (required) — True when the caller can manage this rule: the personal rule owner; for team rules, an account admin or a member of the rule's team. - - created_at (string) (required) — Creation time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - cron_expr (string) (required) — Normalized 5-field cron expression. - enabled (boolean) (required) — Whether the rule is enabled. - environment_id (string) (required) — BYOC Runner ID. @@ -260,12 +260,12 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - prompt (string) (required) — Task prompt. - rule_id (string) (required) — Rule ID. - run_scope (string) (required) — Hidden session run scope. One of: 'person' (personal rule, team_id=0, runs as the creator; disabled when the creator leaves the account), 'team' (team rule, team_id>0, owned by the team and shared with its members; survives the creator leaving). Derived from the rule's team_id. [person, team] - - schedule_next_fire_at_ms (string) (required) — Next scheduled fire time, Unix milliseconds. 0 means no future scheduled fire is available. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - schedule_next_fire_at_ms (string) (required) — Next scheduled fire time, Unix milliseconds. 0 means no future scheduled fire is available. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - schedule_trigger_enabled (boolean) (required) — Whether the schedule trigger is enabled. - schedule_trigger_id (string) — Schedule trigger ID. - team_id (integer) (required) — Scope team ID; 0 means personal rule. - timezone (string) (required) — IANA timezone 'cron_expr' is evaluated in. Always populated for rules created after this field shipped; empty on legacy rows created before it, which still resolve to UTC when scheduled. - - updated_at (string) (required) — Last update time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Example: ` flashduty safari automation-rule-create --data '{"cron_expr":"0 9 * * 1","enabled":true,"http_post_trigger_enabled":true,"name":"Weekly on-call review","oncall_incident_channel_ids":[456],"oncall_incident_severities":["Critical","Warning"],"oncall_incident_trigger_enabled":true,"prompt":"Summarize last week'\''s alert noise and escalation load.","schedule_trigger_enabled":true,"team_id":123,"timezone":"Asia/Shanghai"}'`, RunE: func(cmd *cobra.Command, args []string) error { @@ -499,7 +499,7 @@ Request fields: Response fields ('data' envelope is unwrapped — these fields are at the top level): - account_id (integer) (required) — Account ID. - can_edit (boolean) (required) — True when the caller can manage this rule: the personal rule owner; for team rules, an account admin or a member of the rule's team. - - created_at (string) (required) — Creation time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - cron_expr (string) (required) — Normalized 5-field cron expression. - enabled (boolean) (required) — Whether the rule is enabled. - environment_id (string) (required) — BYOC Runner ID. @@ -517,12 +517,12 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - prompt (string) (required) — Task prompt. - rule_id (string) (required) — Rule ID. - run_scope (string) (required) — Hidden session run scope. One of: 'person' (personal rule, team_id=0, runs as the creator; disabled when the creator leaves the account), 'team' (team rule, team_id>0, owned by the team and shared with its members; survives the creator leaving). Derived from the rule's team_id. [person, team] - - schedule_next_fire_at_ms (string) (required) — Next scheduled fire time, Unix milliseconds. 0 means no future scheduled fire is available. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - schedule_next_fire_at_ms (string) (required) — Next scheduled fire time, Unix milliseconds. 0 means no future scheduled fire is available. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - schedule_trigger_enabled (boolean) (required) — Whether the schedule trigger is enabled. - schedule_trigger_id (string) — Schedule trigger ID. - team_id (integer) (required) — Scope team ID; 0 means personal rule. - timezone (string) (required) — IANA timezone 'cron_expr' is evaluated in. Always populated for rules created after this field shipped; empty on legacy rows created before it, which still resolve to UTC when scheduled. - - updated_at (string) (required) — Last update time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Args: requireBodyFieldOrExactArg("rule_id", "rule-id"), Example: ` flashduty safari automation-rule-update --data '{"cron_expr":"15 9 * * 1","enabled":true,"oncall_incident_channel_ids":[456],"oncall_incident_severities":["Critical","Warning"],"oncall_incident_trigger_enabled":true,"rotate_http_post_trigger_token":true,"rule_id":"arule_7NnLzY2Qp8xS4kUaV3mR6b"}'`, @@ -642,8 +642,8 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - runs (array) (required) — Array of run records for the given 'rule_id', filtered by the request's status/trigger-kind/time-range and paginated. - account_id (integer) (required) — Account ID. - attempts (integer) (required) — Attempt count. - - completed_at (string) (required) — Completion time, Unix milliseconds. 0 means not completed. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. - - created_at (string) (required) — Creation time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - completed_at (string) (required) — Completion time, Unix milliseconds. 0 means not completed. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. + - created_at (string) (required) — Creation time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - duration_ms (integer) (required) — Duration in milliseconds. - error_code (string) — Error code. - error_message (string) — Error message. @@ -652,11 +652,11 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - result_json (any) — Run result JSON. - rule_id (string) (required) — Rule ID. - run_id (string) (required) — Run ID. - - started_at (string) (required) — Start time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - started_at (string) (required) — Start time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - stats_json (any) — Run stats JSON. - status (string) (required) — Run status. One of (the first three are in-flight, the rest terminal): | Value | Meaning | | --- | --- | | 'queued' | Enqueued, waiting for a worker | | 'running' | Executing | | 'retrying' | An attempt failed and a retry is scheduled | | 'succeeded' | Completed successfully | | 'partial' | Partially succeeded (currently only produced by memory-consolidation runs; rule runs never reach it) | | 'failed' | Terminal failure, no further retries | | 'skipped' | Not executed (e.g. grace period expired, trigger or rule invalid); the reason is kept on the run record | | 'abandoned' | Still in-flight past the stale threshold and swept as never-completed (e.g. worker died) | [queued, running, retrying, succeeded, partial, failed, skipped, abandoned] - trigger_kind (string) (required) — Trigger kind. One of: | Value | Meaning | | --- | --- | | 'schedule' | Fired by the rule's schedule trigger | | 'debug' | Debug run (reserved; current rule runs never carry this kind) | | 'manual' | Triggered manually by a user | | 'http_post' | Fired via the rule's HTTP POST webhook | | 'oncall_incident' | Fired by an on-call incident event | [schedule, debug, manual, http_post, oncall_incident] - - updated_at (string) (required) — Last update time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update time, Unix milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - total (integer) (required) — Total count. `, Args: requireBodyFieldOrExactArg("rule_id", "rule-id"), diff --git a/internal/cli/zz_generated_calendars.go b/internal/cli/zz_generated_calendars.go index 10bf060..8ddd424 100644 --- a/internal/cli/zz_generated_calendars.go +++ b/internal/cli/zz_generated_calendars.go @@ -87,7 +87,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - items (array) (required) — Calendar events sorted by start_at. - account_id (integer) — Account ID. Only present for private events. - cal_id (string) (required) — Calendar ID. For public events this is a locale key such as zh-cn.china.official. - - created_at (string) (required) — Creation timestamp (Unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (Unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) — Creator person ID. Only present for private events. - description (string) (required) — Event description. - end_at (string) (required) — Event end date (YYYY-MM-DD, exclusive). @@ -95,7 +95,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - is_off (boolean) (required) — Whether the event marks a non-working day. - start_at (string) (required) — Event start date (YYYY-MM-DD). - summary (string) (required) — Event summary. - - updated_at (string) (required) — Last update timestamp (Unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp (Unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - total (integer) (required) — Total number of events returned. `, Args: requireBodyFieldOrExactArg("cal_id", "cal-id"), @@ -381,7 +381,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - account_id (integer) (required) — Account ID. - cal_id (string) (required) — Calendar ID. - cal_name (string) (required) — Calendar display name. - - created_at (string) (required) — Creation timestamp (Unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (Unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — Creator person ID. - description (string) (required) — Calendar description. - extra_cal_ids (array) — Inherited public-holiday calendar IDs. @@ -389,7 +389,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - status (string) (required) — Calendar status. 'enabled' means usable; 'deleted' means removed and never returned by list endpoints. [enabled, deleted] - team_id (integer) (required) — Owning team ID (0 when not assigned). - timezone (string) (required) — IANA timezone. - - updated_at (string) (required) — Last update timestamp (Unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp (Unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Last updater person ID. - workdays (array) — Workday numbers (0 = Sunday, 6 = Saturday). `, @@ -448,7 +448,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - account_id (integer) (required) — Account ID. - cal_id (string) (required) — Calendar ID. - cal_name (string) (required) — Calendar display name. - - created_at (string) (required) — Creation timestamp (Unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (Unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — Creator person ID. - description (string) (required) — Calendar description. - extra_cal_ids (array) — Inherited public-holiday calendar IDs. @@ -456,7 +456,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - status (string) (required) — Calendar status. 'enabled' means usable; 'deleted' means removed and never returned by list endpoints. [enabled, deleted] - team_id (integer) (required) — Owning team ID (0 when not assigned). - timezone (string) (required) — IANA timezone. - - updated_at (string) (required) — Last update timestamp (Unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp (Unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Last updater person ID. - workdays (array) — Workday numbers (0 = Sunday, 6 = Saturday). - total (integer) (required) — Total number of calendars returned. diff --git a/internal/cli/zz_generated_changes.go b/internal/cli/zz_generated_changes.go index 8081078..2670e15 100644 --- a/internal/cli/zz_generated_changes.go +++ b/internal/cli/zz_generated_changes.go @@ -56,28 +56,28 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - channel_name (string) — Name of the collaboration channel. - channel_status (string) — Status of the collaboration channel. - description (string) — Change description. - - end_time (string) — Unix timestamp in seconds when the change ended. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - end_time (string) — Unix timestamp in seconds when the change ended. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - events (array) — Underlying change events, returned only when include_events is true. - account_id (integer) — Account this change event belongs to. - change_key (string) — Stable key that groups events belonging to the same change. - change_status (string) — Lifecycle status of the change event, reported by the change source as execution progresses. | Value | Meaning | |---|---| | 'Planned' | Planned, not started. | | 'Ready' | Ready for execution. | | 'Processing' | Being executed. | | 'Canceled' | Canceled. | | 'Done' | Completed. | [Planned, Ready, Processing, Canceled, Done] - channel_id (integer) — Collaboration channel this change event is routed to. - - created_at (string) — Unix timestamp in seconds when the change event was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. - - deleted_at (string) — Unix timestamp in seconds when the change event was deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Unix timestamp in seconds when the change event was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. + - deleted_at (string) — Unix timestamp in seconds when the change event was deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) — Change event description. - event_id (string) — Change event ID, a MongoDB ObjectID hex string. - - event_time (string) — Unix timestamp in seconds when the change event occurred. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - event_time (string) — Unix timestamp in seconds when the change event occurred. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - integration_id (integer) — Integration that reported this change event. - labels (object) — Key-value labels attached to the change event. - link (string) — External link to the source change record. - title (string) — Change event title. - - updated_at (string) — Unix timestamp in seconds when the change event was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Unix timestamp in seconds when the change event was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - integration_id (integer) — Integration that reported this change. - integration_name (string) — Name of the reporting integration. - labels (object) — Key-value labels attached to the change. - - last_time (string) — Unix timestamp in seconds of the most recent change activity. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_time (string) — Unix timestamp in seconds of the most recent change activity. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - link (string) — External link to the source change record. - - start_time (string) — Unix timestamp in seconds when the change started. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - start_time (string) — Unix timestamp in seconds when the change started. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - title (string) — Change title. - total (integer) — Total number of matching changes. `, diff --git a/internal/cli/zz_generated_channels.go b/internal/cli/zz_generated_channels.go index d4198ba..ab74e2c 100644 --- a/internal/cli/zz_generated_channels.go +++ b/internal/cli/zz_generated_channels.go @@ -595,8 +595,8 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - aggr_window (integer) (required) — Delay window in seconds. - channel_id (integer) (required) — Channel the rule belongs to. - channel_name (string) — Channel name, populated for cross-channel listing responses. - - created_at (string) (required) — Creation timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. - - deleted_at (string) — Deletion timestamp (unix seconds). Emitted only for soft-deleted rules. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. + - deleted_at (string) — Deletion timestamp (unix seconds). Emitted only for soft-deleted rules. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Rule description. - filters (object) (required) - layers (array) (required) — Escalation levels in order. @@ -628,7 +628,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - is_off (boolean) — When true, match days marked as days-off in the calendar. - repeat (array) — Days of the week this window repeats on. Empty means every day. - start (string) — Start of the window in 'HH:MM'. - - updated_at (string) (required) — Last update timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Member ID that last updated the rule. `, Example: ` flashduty channel escalate-rule-info --data '{"channel_id":1001,"rule_id":"6621b23f4a2c5e0012ab34d0"}'`, @@ -685,8 +685,8 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - aggr_window (integer) (required) — Delay window in seconds. - channel_id (integer) (required) — Channel the rule belongs to. - channel_name (string) — Channel name, populated for cross-channel listing responses. - - created_at (string) (required) — Creation timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. - - deleted_at (string) — Deletion timestamp (unix seconds). Emitted only for soft-deleted rules. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. + - deleted_at (string) — Deletion timestamp (unix seconds). Emitted only for soft-deleted rules. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Rule description. - filters (object) (required) - layers (array) (required) — Escalation levels in order. @@ -712,7 +712,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - is_off (boolean) — When true, match days marked as days-off in the calendar. - repeat (array) — Days of the week this window repeats on. Empty means every day. - start (string) — Start of the window in 'HH:MM'. - - updated_at (string) (required) — Last update timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Member ID that last updated the rule. `, Args: requireBodyFieldOrExactArg("channel_id", "channel-id"), @@ -879,10 +879,10 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - auto_resolve_timeout (integer) — Auto-resolve timeout in seconds. 0 disables auto-resolve. - channel_id (integer) — Channel ID. - channel_name (string) — Channel name. - - created_at (string) — Creation timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) — Member ID who created the channel. - creator_name (string) — Name of the member who created the channel (resolved from the member directory; empty when unavailable). - - deleted_at (string) — Deletion timestamp (unix seconds). Non-zero only for soft-deleted channels. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Deletion timestamp (unix seconds). Non-zero only for soft-deleted channels. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) — Free-form description. - disable_auto_close (boolean) — When true, automatic incident closing is disabled. - disable_outlier_detection (boolean) — When true, outlier incident detection is disabled. @@ -906,7 +906,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - is_external_report_enabled (boolean) — Whether external reporters can file incidents into this channel. - is_private (boolean) — When true, the channel is visible only to its managing teams. - is_starred (boolean) — Whether the current user has starred this channel. - - last_incident_at (string) — Timestamp of the most recent incident (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_incident_at (string) — Timestamp of the most recent incident (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - managing_team_ids (array) — Additional teams that can manage the channel. - progress_to_incident_cnts (object) - Processing (integer) (required) — Count of processing incidents in the last 30 days. @@ -914,7 +914,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - status (string) — Channel status. 'enabled' receives and processes events normally; 'disabled' drops incoming events outright; 'deleted' is returned only when fetching a channel by ID — list endpoints never return it. [enabled, disabled, deleted] - team_id (integer) — Owning team ID. - team_name (string) — Owning team name (resolved from the team directory; empty when unavailable). - - updated_at (string) — Last update timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Aliases: []string{"get", "detail"}, Args: requireBodyFieldOrExactArg("channel_id", "channel-id"), @@ -1269,7 +1269,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - items (array) (required) — All inhibit rules of the channel, excluding deleted ones, ordered by creation time ascending. - account_id (integer) (required) — ID of the account the rule belongs to. - channel_id (integer) (required) — ID of the channel the rule belongs to. - - created_at (string) (required) — Creation time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Rule description. - equals (array) (required) — Label keys used to pair source and target alerts. - is_directly_discard (boolean) (required) — When true, the inhibited target alert is discarded outright; when false, the alert is still created but muted — no incident is triggered and no notification is sent. @@ -1278,7 +1278,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - source_filters (object) (required) - status (string) (required) — Rule status: 'enabled' or 'disabled'; deleted rules never appear in the list. [enabled, disabled] - target_filters (object) (required) - - updated_at (string) (required) — Last update time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — ID of the user who last updated the rule. `, Args: requireBodyFieldOrExactArg("channel_id", "channel-id"), @@ -1442,10 +1442,10 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - auto_resolve_timeout (integer) — Auto-resolve timeout in seconds. 0 disables auto-resolve. - channel_id (integer) — Channel ID. - channel_name (string) — Channel name. - - created_at (string) — Creation timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) — Member ID who created the channel. - creator_name (string) — Name of the member who created the channel (resolved from the member directory; empty when unavailable). - - deleted_at (string) — Deletion timestamp (unix seconds). Non-zero only for soft-deleted channels. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Deletion timestamp (unix seconds). Non-zero only for soft-deleted channels. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) — Free-form description. - disable_auto_close (boolean) — When true, automatic incident closing is disabled. - disable_outlier_detection (boolean) — When true, outlier incident detection is disabled. @@ -1469,7 +1469,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - is_external_report_enabled (boolean) — Whether external reporters can file incidents into this channel. - is_private (boolean) — When true, the channel is visible only to its managing teams. - is_starred (boolean) — Whether the current user has starred this channel. - - last_incident_at (string) — Timestamp of the most recent incident (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_incident_at (string) — Timestamp of the most recent incident (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - managing_team_ids (array) — Additional teams that can manage the channel. - progress_to_incident_cnts (object) - Processing (integer) (required) — Count of processing incidents in the last 30 days. @@ -1477,7 +1477,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - status (string) — Channel status. 'enabled' receives and processes events normally; 'disabled' drops incoming events outright; 'deleted' is returned only when fetching a channel by ID — list endpoints never return it. [enabled, disabled, deleted] - team_id (integer) — Owning team ID. - team_name (string) — Owning team name (resolved from the team directory; empty when unavailable). - - updated_at (string) — Last update timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update timestamp (unix seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - total (integer) (required) — Total matching channels. `, Example: ` flashduty channel list --data '{"asc":false,"limit":20,"orderby":"created_at","p":1}'`, @@ -1833,7 +1833,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - items (array) (required) — All silence rules of the channel, excluding deleted ones, ordered by creation time ascending. - account_id (integer) (required) — ID of the account the rule belongs to. - channel_id (integer) (required) — ID of the channel the rule belongs to. - - created_at (string) (required) — Creation time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Rule description. - filters (object) (required) - from_incident_id (string) — Source incident ID when the silence was created from an incident. @@ -1852,7 +1852,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - is_off (boolean) — When true, match days marked as days-off in the calendar. - repeat (array) — Days of the week this window repeats on. Empty means every day. - start (string) — Start of the window in 'HH:MM'. - - updated_at (string) (required) — Last update time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — ID of the user who last updated the rule. `, Args: requireBodyFieldOrExactArg("channel_id", "channel-id"), @@ -2231,13 +2231,13 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - items (array) (required) — All drop (unsubscribe) rules of the channel, excluding deleted ones, ordered by creation time ascending. - account_id (integer) (required) — ID of the account the rule belongs to. - channel_id (integer) (required) — ID of the channel the rule belongs to. - - created_at (string) (required) — Creation time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Rule description. - filters (object) (required) - rule_id (string) (required) — Rule ID (MongoDB ObjectID). - rule_name (string) (required) — Rule name. - status (string) (required) — Rule status: 'enabled' or 'disabled'; deleted rules never appear in the list. [enabled, disabled] - - updated_at (string) (required) — Last update time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — ID of the user who last updated the rule. `, Args: requireBodyFieldOrExactArg("channel_id", "channel-id"), @@ -2498,17 +2498,17 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - vals (array) (required) — Values to compare against. Each value may be a literal string, a wildcard ('*', '?'), a regular expression wrapped in slashes ('/pattern/'), a CIDR ('cidr:10.0.0.0/8'), or a numeric comparison ('num:lt:100'). - name_mapping_label (string) — Label key whose value is used as the target channel name. Required when 'routing_mode' is 'name_mapping'. - routing_mode (string) — Routing mode. 'standard' (default, also used when left empty) routes to the fixed channel IDs; 'name_mapping' resolves channels by reading a label value from the alert event. [standard, name_mapping] - - created_at (string) — Creation time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — ID of the person who created the rule. - default (object) — Default branch used when no case matches (or all matched cases yield no valid channels). - channel_ids (array) — Channel IDs to fall back to. - - deleted_at (string) — Soft-delete timestamp, Unix seconds. Omitted when the rule is active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp, Unix seconds. Omitted when the rule is active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - integration_id (integer) — Integration the rule belongs to. - sections (array) — Optional sections that visually group cases. - name (string) (required) — Section name. Must be unique within the rule. - position (integer) (required) — Index in 'cases' where this section starts. Must be between 0 and the length of 'cases'. - status (string) — Route status. 'enabled' means active; 'deleted' means removed, visible only in historical versions. [enabled, deleted] - - updated_at (string) — Last update time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — ID of the person who performed the last update. - version (integer) (required) — Monotonic version number, incremented on each update. Use it for optimistic concurrency control. `, @@ -2571,17 +2571,17 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - vals (array) (required) — Values to compare against. Each value may be a literal string, a wildcard ('*', '?'), a regular expression wrapped in slashes ('/pattern/'), a CIDR ('cidr:10.0.0.0/8'), or a numeric comparison ('num:lt:100'). - name_mapping_label (string) — Label key whose value is used as the target channel name. Required when 'routing_mode' is 'name_mapping'. - routing_mode (string) — Routing mode. 'standard' (default, also used when left empty) routes to the fixed channel IDs; 'name_mapping' resolves channels by reading a label value from the alert event. [standard, name_mapping] - - created_at (string) — Creation time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — ID of the person who created the rule. - default (object) — Default branch used when no case matches (or all matched cases yield no valid channels). - channel_ids (array) — Channel IDs to fall back to. - - deleted_at (string) — Soft-delete timestamp, Unix seconds. Omitted when the rule is active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp, Unix seconds. Omitted when the rule is active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - integration_id (integer) — Integration the rule belongs to. - sections (array) — Optional sections that visually group cases. - name (string) (required) — Section name. Must be unique within the rule. - position (integer) (required) — Index in 'cases' where this section starts. Must be between 0 and the length of 'cases'. - status (string) — Route status. 'enabled' means active; 'deleted' means removed, visible only in historical versions. [enabled, deleted] - - updated_at (string) — Last update time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update time, Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — ID of the person who performed the last update. - version (integer) (required) — Monotonic version number, incremented on each update. Use it for optimistic concurrency control. `, diff --git a/internal/cli/zz_generated_data_sources.go b/internal/cli/zz_generated_data_sources.go index 6a41032..fd352b9 100644 --- a/internal/cli/zz_generated_data_sources.go +++ b/internal/cli/zz_generated_data_sources.go @@ -139,7 +139,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - tls_server_name (string) — Server name used for TLS SNI and certificate verification; defaults to the host from the connection address when empty. - tls_skip_verify (boolean) — Whether to skip server certificate verification (insecure, for self-signed setups only). - type_ident (string) (required) — Datasource type identifier. Allowed: 'prometheus', 'loki', 'mysql', 'oracle', 'postgres', 'clickhouse', 'elasticsearch', 'sls', 'victorialogs'. - - updated_at (string) (required) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Example: ` flashduty monit datasource-info --data '{"id":10}'`, RunE: func(cmd *cobra.Command, args []string) error { @@ -301,7 +301,7 @@ Response fields ('data' is a TOP-LEVEL array of these row objects — pipe 'jq ' - tls_server_name (string) — Server name used for TLS SNI and certificate verification; defaults to the host from the connection address when empty. - tls_skip_verify (boolean) — Whether to skip server certificate verification (insecure, for self-signed setups only). - type_ident (string) (required) — Datasource type identifier. Allowed: 'prometheus', 'loki', 'mysql', 'oracle', 'postgres', 'clickhouse', 'elasticsearch', 'sls', 'victorialogs'. - - updated_at (string) (required) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Example: ` flashduty monit datasource-list --data '{"type":"prometheus"}'`, RunE: func(cmd *cobra.Command, args []string) error { @@ -704,7 +704,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - tls_server_name (string) — Server name used for TLS SNI and certificate verification; defaults to the host from the connection address when empty. - tls_skip_verify (boolean) — Whether to skip server certificate verification (insecure, for self-signed setups only). - type_ident (string) (required) — Datasource type identifier. Allowed: 'prometheus', 'loki', 'mysql', 'oracle', 'postgres', 'clickhouse', 'elasticsearch', 'sls', 'victorialogs'. - - updated_at (string) (required) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Example: ` flashduty monit datasource-create --data '{"address":"http://prometheus.example.com:9090","edge_cluster_name":"default","name":"Prometheus Prod","note":"Production Prometheus","payload":{"prometheus":{"basic_auth_enabled":false}},"type_ident":"prometheus"}'`, RunE: func(cmd *cobra.Command, args []string) error { @@ -1051,7 +1051,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - tls_server_name (string) — Server name used for TLS SNI and certificate verification; defaults to the host from the connection address when empty. - tls_skip_verify (boolean) — Whether to skip server certificate verification (insecure, for self-signed setups only). - type_ident (string) (required) — Datasource type identifier. Allowed: 'prometheus', 'loki', 'mysql', 'oracle', 'postgres', 'clickhouse', 'elasticsearch', 'sls', 'victorialogs'. - - updated_at (string) (required) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Example: ` flashduty monit datasource-update --data '{"address":"http://prometheus-v2.example.com:9090","edge_cluster_name":"default","id":10,"name":"Prometheus Prod v2","note":"Updated","payload":{"prometheus":{"basic_auth_enabled":false}},"type_ident":"prometheus"}'`, RunE: func(cmd *cobra.Command, args []string) error { diff --git a/internal/cli/zz_generated_diagnostics.go b/internal/cli/zz_generated_diagnostics.go index 69d9baa..339043c 100644 --- a/internal/cli/zz_generated_diagnostics.go +++ b/internal/cli/zz_generated_diagnostics.go @@ -364,7 +364,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - edge_ipport (string) — Edge instance address ('ip:port'), surfaced for diagnostics. - target_kind (string) — Target kind, e.g. 'host', 'mysql'. Filtering by kind is not supported in v1. - target_locator (string) — Target identifier; the list is sorted by this field ascending. - - updated_at (string) — Last route-projection upsert time, Unix seconds. Treat as 'most recently observed', not a live-online indicator. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last route-projection upsert time, Unix seconds. Treat as 'most recently observed', not a live-online indicator. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - next_cursor (string) — Opaque cursor for the next page. Absent / empty means this is the last page. - total (integer) — Total matches for the current '(account_id, keyword)' pair, independent of 'cursor'. `, diff --git a/internal/cli/zz_generated_error_ingestion_rules.go b/internal/cli/zz_generated_error_ingestion_rules.go index e056590..c650e2e 100644 --- a/internal/cli/zz_generated_error_ingestion_rules.go +++ b/internal/cli/zz_generated_error_ingestion_rules.go @@ -269,9 +269,9 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - rules (array) (required) — The application's complete rule list as of this version. - account_id (integer) (required) — Account ID. - application_id (string) (required) — RUM application ID the rule belongs to. - - created_at (string) (required) — Unix timestamp in milliseconds when the row was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Unix timestamp in milliseconds when the row was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID who created the rule. - - deleted_at (string) (required) — Unix timestamp in milliseconds when the row was soft-deleted; '0' when not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) (required) — Unix timestamp in milliseconds when the row was soft-deleted; '0' when not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Rule description. - filters (array>) (required) — The rule's filter conditions as of this snapshot version. - key (string) (required) — Field key. One of 'error.usr_id', 'error.usr_email', 'error.error_type', 'error.error_message', 'error.error_stack', 'error.view_url', 'error.env', 'error.version', 'error.service', 'error.browser_name', 'error.browser_version', 'error.fingerprint', 'error.is_crash', or a 'context.'-prefixed custom context path (up to 3 levels deep). @@ -281,9 +281,9 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - rule_id (string) (required) — Rule ID. - rule_name (string) (required) — Rule name. - status (string) (required) — The rule's status as of this snapshot version. [enabled, disabled] - - updated_at (string) (required) — Unix timestamp in milliseconds when the row was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Unix timestamp in milliseconds when the row was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Member ID who last updated the rule. - - updated_at (string) (required) — Unix timestamp in milliseconds when this snapshot was recorded. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Unix timestamp in milliseconds when this snapshot was recorded. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Member ID whose action triggered this snapshot. - updated_by_name (string) (required) — Display name of the member whose action triggered this snapshot. - version (integer) (required) — History version number, incrementing from 1. @@ -417,7 +417,7 @@ Request fields: Response fields ('data' envelope is unwrapped — rows are nested under items[]; pipe 'jq '.items[]'', NOT '.data.items[]'): - items (array) (required) — Rules, newest-created first. - - created_at (string) (required) — Unix timestamp in milliseconds when the rule was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Unix timestamp in milliseconds when the rule was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Rule description, up to 512 characters. - filters (array>) (required) — The rule's filter conditions. - key (string) (required) — Field key. One of 'error.usr_id', 'error.usr_email', 'error.error_type', 'error.error_message', 'error.error_stack', 'error.view_url', 'error.env', 'error.version', 'error.service', 'error.browser_name', 'error.browser_version', 'error.fingerprint', 'error.is_crash', or a 'context.'-prefixed custom context path (up to 3 levels deep). @@ -426,7 +426,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - rule_id (string) (required) — Rule ID. - rule_name (string) (required) — Rule name, 1-128 characters. Not required to be unique within the application. - status (string) (required) — Current status of the rule. [enabled, disabled] - - updated_at (string) (required) — Unix timestamp in milliseconds when the rule was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Unix timestamp in milliseconds when the rule was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Args: requireBodyFieldOrExactArg("application_id", "application-id"), Example: ` flashduty rum error-ingestion-rules-list --data '{"application_id":"WoyQQ3BohkdtPivubEvE8o"}'`, diff --git a/internal/cli/zz_generated_im_integrations.go b/internal/cli/zz_generated_im_integrations.go index 8aef46a..6fd10f7 100644 --- a/internal/cli/zz_generated_im_integrations.go +++ b/internal/cli/zz_generated_im_integrations.go @@ -19,14 +19,14 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - items (array) — IM integrations with the war-room feature enabled. - account_id (integer) — Account this integration belongs to. - category (string) — Category of the integration plugin. - - created_at (string) — Unix timestamp in seconds when the integration was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Unix timestamp in seconds when the integration was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) — Person who created the integration. - data_source_id (integer) — Integration ID. - description (string) — Integration description. - exclusive_data_source_id (integer) — Exclusive integration ID associated with this integration. - integration_id (integer) — Integration ID, alias of data_source_id. - integration_key (string) — Push key used by alert sources to send to this integration. - - last_time (string) — Unix timestamp in seconds of the most recent activity on the integration. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_time (string) — Unix timestamp in seconds of the most recent activity on the integration. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - name (string) — Integration name. - no_editable (boolean) — Whether the integration is read-only. - plugin_id (integer) — Plugin ID backing this integration. @@ -36,7 +36,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - settings (object) — Plugin-specific configuration of the integration. - status (string) — Current status of the integration. - team_id (integer) — Team that owns this integration. - - updated_at (string) — Unix timestamp in seconds when the integration was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Unix timestamp in seconds when the integration was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) — Person who last updated the integration. `, Example: ` flashduty datasource im-war-room-enabled-list --data '{}'`, diff --git a/internal/cli/zz_generated_incidents.go b/internal/cli/zz_generated_incidents.go index d24b56c..1cda8ab 100644 --- a/internal/cli/zz_generated_incidents.go +++ b/internal/cli/zz_generated_incidents.go @@ -186,7 +186,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - items (array) (required) — Synchronization records on the current page. - channel_id (integer) (required) — Channel ID for the incident. - channel_name (string) (required) — Channel name for the incident. - - created_at (string) (required) — Mapping record creation time, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Mapping record creation time, Unix seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - error_message (string) — Error message when synchronization failed. Usually absent on successful records. - incident_id (string) (required) — Associated Flashduty incident ID. - incident_title (string) (required) — Associated incident title. @@ -434,28 +434,28 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - channel_id (integer) (required) — Channel ID. - channel_name (string) (required) — Channel display name. - channel_status (string) (required) — Channel status. - - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) (required) — Deprecated. Use 'integration_id' instead. - data_source_name (string) (required) — Deprecated. Use 'integration_name'. - data_source_ref_id (string) (required) — Deprecated. Use 'integration_ref_id'. - data_source_type (string) — Deprecated. Use 'integration_type'. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Alert description. - - end_time (string) (required) — Unix timestamp (seconds) when the alert recovered. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - end_time (string) (required) — Unix timestamp (seconds) when the alert recovered. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - event_cnt (integer) (required) — Total number of raw events merged into this alert. - events (array) — Raw alert event preview, populated only when requested. Capped at the 20 newest events per alert. - account_id (integer) — Account ID. - alert_id (string) — Parent alert ID (MongoDB ObjectID). - alert_key (string) — Deduplication key used to merge events into an alert. - channel_id (integer) — Channel ID the event is routed to. - - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) — Deprecated. Use 'integration_id' instead. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) — Event description. - event_id (string) — Event ID (MongoDB ObjectID). - event_severity (string) — Severity of this event. [Critical, Warning, Info, Ok] - event_status (string) — Status of this event. [Critical, Warning, Info, Ok] - - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - images (array) — Images attached to the event. - alt (string) — Alt text. - href (string) — Optional link URL when the image is clicked. @@ -465,7 +465,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - labels (object) — Label key-value pairs. - title (string) — Event title. - title_rule (string) — Title template used to derive 'title' from labels. - - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - ever_muted (boolean) (required) — Whether this alert has ever been silenced. - images (array) (required) — Attached images. - alt (string) — Alt text. @@ -480,13 +480,13 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - integration_ref_id (string) (required) — Integration reference ID. - integration_type (string) (required) — Integration type string. - labels (object) (required) — Alert labels. - - last_time (string) (required) — Unix timestamp (seconds) of the most recent event. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_time (string) (required) — Unix timestamp (seconds) of the most recent event. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - responder_email (string) (required) — Primary responder email, if any. - responder_name (string) (required) — Primary responder name, if any. - - start_time (string) (required) — Unix timestamp (seconds) when the alert first fired. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - start_time (string) (required) — Unix timestamp (seconds) when the alert first fired. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - title (string) (required) — Alert title. - title_rule (string) (required) — Title rendering rule. - - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - total (integer) (required) — Total matching alerts. `, Args: requireBodyFieldOrExactArg("incident_id", "incident-id"), @@ -702,11 +702,11 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - account_id (integer) — Account ID that owns the comment type. - color (string) — Label color as a hex value in #RRGGBB format (stored uppercase). - comment_type_id (string) — Comment type ID (24-character hex ObjectID). - - created_at (string) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) — ID of the user who created the comment type. - name (string) — Display name of the comment type. Unique within the account (case-insensitive, trimmed). (≤40 chars) - position (integer) — 1-based display position of the comment type. - - updated_at (string) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) — ID of the user who last updated the comment type. `, Example: ` flashduty incident comment-type-create --data '{"color":"#30A46C","name":"Key finding"}'`, @@ -810,11 +810,11 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - account_id (integer) — Account ID that owns the comment type. - color (string) — Label color as a hex value in #RRGGBB format (stored uppercase). - comment_type_id (string) — Comment type ID (24-character hex ObjectID). - - created_at (string) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) — ID of the user who created the comment type. - name (string) — Display name of the comment type. Unique within the account (case-insensitive, trimmed). (≤40 chars) - position (integer) — 1-based display position of the comment type. - - updated_at (string) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) — ID of the user who last updated the comment type. `, Example: ` flashduty incident comment-type-list --data '{}'`, @@ -1166,9 +1166,9 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - has_next_page (boolean) (required) — True when more entries are available. - items (array) (required) — Timeline entries for the current page. - account_id (integer) (required) — Account ID. - - created_at (string) (required) — Creation timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — User ID of the actor. '0' means system-generated. - - deleted_at (string) — Soft-delete timestamp (ms). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (ms). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - detail (object) (required) — Type-specific payload. The concrete shape is determined by 'type'. - added_assignee_ids (array) — Member IDs added as assignees. - assigned_at (integer) — Unix timestamp (seconds) when the assignment was made. @@ -1254,7 +1254,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - work_item_id (string) — Work item ID. - ref_id (string) (required) — ObjectID of the source alert or incident this entry references. - type (string) (required) — Incident timeline entry type. Each value identifies one lifecycle event; the matching 'detail' payload shape is determined by this field. Incident types are prefixed with 'i_'. | Type | Meaning | |---|---| | 'i_new' | Incident Created: A new incident was created automatically or manually. | | 'i_assign' | Assigned: Incident was assigned to responders. | | 'i_a_rspd' | Responder Added: Additional responders joined the incident. | | 'i_notify' | Notification dispatched through a channel at a specific escalation level. | | 'i_storm' | Alert storm threshold reached on the incident. | | 'i_snooze' | Notifications snoozed for a given duration. | | 'i_wake' | Snooze cancelled and notifications resumed. | | 'i_ack' | Acknowledged: Responder confirmed they are working on the incident. | | 'i_unack' | Acknowledgement removed. | | 'i_comm' | Comment: Responder logged progress or key information. | | 'i_rslv' | Resolved: Incident was marked as resolved. | | 'i_reopen' | Reopened: Resolved incident was reopened, possibly due to recurrence. | | 'i_merge' | Merged: Multiple related incidents were merged into one. | | 'i_r_title' | Title updated. | | 'i_r_desc' | Description updated. | | 'i_r_impact' | Impact updated. | | 'i_r_rc' | Root cause updated. | | 'i_r_rsltn' | Resolution updated. | | 'i_r_severity' | Severity Changed: Incident severity level was adjusted. | | 'i_r_field' | Custom field value updated. | | 'i_m_flapping' | Incident muted by flapping detection. | | 'i_m_reply' | Mute reply marker on a comment. | | 'i_custom' | Action: Automated action or script was triggered. | | 'i_wr_create' | War Room Created: Chat group was created for collaborative response. | | 'i_wr_delete' | War room chat group deleted. | | 'i_auto_refresh' | Card auto-refresh event posted back to the timeline. | | 'i_wi_created' | Work Item Created: An Action or Follow-up was created. | | 'i_wi_updated' | Work Item Updated: Title, description, status, or priority was changed. | | 'i_wi_assignees' | Work Item Assignees Changed: Assignees were updated. | | 'i_wi_completed' | Work Item Completed: An assignee marked the work item complete. | | 'i_wi_converted' | Work Item Converted: An Action was converted to a Follow-up. | | 'i_wi_bound' | Work Item Bound: A converted Follow-up was bound to a post-mortem. | | 'i_wi_deleted' | Work Item Deleted: An Action or Follow-up was soft-deleted. | | 'a_merge' | Alert Merged: An alert was merged into an existing incident. | [i_new, i_assign, i_a_rspd, i_notify, i_storm, i_snooze, i_wake, i_ack, i_unack, i_comm, i_rslv, i_reopen, i_merge, i_r_title, i_r_desc, i_r_impact, i_r_rc, i_r_rsltn, i_r_severity, i_r_field, i_m_flapping, i_m_reply, i_custom, i_wr_create, i_wr_delete, i_auto_refresh, i_wi_created, i_wi_updated, i_wi_assignees, i_wi_completed, i_wi_converted, i_wi_bound, i_wi_deleted, a_merge] - - updated_at (string) (required) — Last update timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Args: requireBodyFieldOrExactArg("incident_id", "incident-id"), Example: ` flashduty incident feed --data '{"incident_id":"69da451ef77b1b51f40e83ee","limit":20,"p":1}'`, @@ -1390,7 +1390,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - account_locale (string) (required) — Account locale. - account_name (string) (required) — Account name. - account_time_zone (string) (required) — Account time zone. - - ack_time (string) (required) — Unix timestamp (seconds) when the incident was first acknowledged. 0 if unacknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - ack_time (string) (required) — Unix timestamp (seconds) when the incident was first acknowledged. 0 if unacknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - active_alert_cnt (integer) (required) — Count of alerts currently in Critical/Warning/Info state. - ai_summary (string) (required) — AI-generated summary of the incident. - alert_cnt (integer) (required) — Total count of alerts merged into this incident. @@ -1404,28 +1404,28 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - channel_id (integer) (required) — Channel ID. - channel_name (string) (required) — Channel display name. - channel_status (string) (required) — Channel status. - - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) (required) — Deprecated. Use 'integration_id' instead. - data_source_name (string) (required) — Deprecated. Use 'integration_name'. - data_source_ref_id (string) (required) — Deprecated. Use 'integration_ref_id'. - data_source_type (string) — Deprecated. Use 'integration_type'. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Alert description. - - end_time (string) (required) — Unix timestamp (seconds) when the alert recovered. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - end_time (string) (required) — Unix timestamp (seconds) when the alert recovered. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - event_cnt (integer) (required) — Total number of raw events merged into this alert. - events (array) — Raw alert event preview, populated only when requested. Capped at the 20 newest events per alert. - account_id (integer) — Account ID. - alert_id (string) — Parent alert ID (MongoDB ObjectID). - alert_key (string) — Deduplication key used to merge events into an alert. - channel_id (integer) — Channel ID the event is routed to. - - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) — Deprecated. Use 'integration_id' instead. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) — Event description. - event_id (string) — Event ID (MongoDB ObjectID). - event_severity (string) — Severity of this event. [Critical, Warning, Info, Ok] - event_status (string) — Status of this event. [Critical, Warning, Info, Ok] - - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - images (array) — Images attached to the event. - alt (string) — Alt text. - href (string) — Optional link URL when the image is clicked. @@ -1435,7 +1435,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - labels (object) — Label key-value pairs. - title (string) — Event title. - title_rule (string) — Title template used to derive 'title' from labels. - - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - ever_muted (boolean) (required) — Whether this alert has ever been silenced. - images (array) (required) — Attached images. - alt (string) — Alt text. @@ -1450,13 +1450,13 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - integration_ref_id (string) (required) — Integration reference ID. - integration_type (string) (required) — Integration type string. - labels (object) (required) — Alert labels. - - last_time (string) (required) — Unix timestamp (seconds) of the most recent event. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_time (string) (required) — Unix timestamp (seconds) of the most recent event. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - responder_email (string) (required) — Primary responder email, if any. - responder_name (string) (required) — Primary responder name, if any. - - start_time (string) (required) — Unix timestamp (seconds) when the alert first fired. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - start_time (string) (required) — Unix timestamp (seconds) when the alert first fired. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - title (string) (required) — Alert title. - title_rule (string) (required) — Title rendering rule. - - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - assigned_to (object) (required) — Current assignment target for the incident. - assigned_at (integer) — Unix timestamp (seconds) when the assignment was made. - emails (array) — Email recipients, used by integrations such as ServiceNow. @@ -1473,14 +1473,14 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - channel_id (integer) (required) — Channel ID. 0 for standalone incidents. - channel_name (string) (required) — Channel display name. - channel_status (string) (required) — Channel status. - - close_time (string) (required) — Unix timestamp (seconds) when the incident was closed. 0 if still open. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - close_time (string) (required) — Unix timestamp (seconds) when the incident was closed. 0 if still open. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - closer (object) — Closer member info. - as (string) — Role label for this member in the context of the current object. - email (string) — Member email address. - person_id (integer) — Member ID. - person_name (string) — Member display name. - closer_id (integer) (required) — Member ID that closed the incident. 0 if auto-closed. - - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator (object) — Creator member info. - as (string) — Role label for this member in the context of the current object. - email (string) — Member email address. @@ -1492,10 +1492,10 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - data_source_type (string) — Deprecated. Use 'integration_type' instead. - data_source_types (array) — Deprecated. Use 'integration_types' instead. - dedup_key (string) (required) — Deduplication key used to coalesce alerts. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Incident description. - detail_url (string) (required) — Web console URL for the incident. - - end_time (string) (required) — Unix timestamp (seconds) when the incident ended. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - end_time (string) (required) — Unix timestamp (seconds) when the incident ended. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - equals_md5 (string) (required) — MD5 hash used for content-equality checks. - ever_muted (boolean) (required) — Whether the incident has ever been silenced. - fields (object) (required) — Custom field values keyed by field name. @@ -1514,7 +1514,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - integration_type (string) — First alert's integration type string, used by the detail page for label mappings. - integration_types (array) (required) — Integration type strings for all contributing integrations. - labels (object) (required) — Labels propagated from alerts. - - last_time (string) (required) — Unix timestamp (seconds) of the most recent update. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_time (string) (required) — Unix timestamp (seconds) of the most recent update. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - links (array) — Channel-level link integrations rendered for this incident. - endpoint (string) (required) — Rendered URL for the link. - name (string) (required) — Display name of the link. @@ -1532,18 +1532,18 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - reporter_email (string) — Reporter email for manually created incidents. - resolution (string) (required) — Resolution notes. - responders (array) (required) — Current responders with assignment/acknowledgement state. - - acknowledged_at (string) (required) — Unix timestamp (seconds) when the member acknowledged. 0 if not yet acknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - acknowledged_at (string) (required) — Unix timestamp (seconds) when the member acknowledged. 0 if not yet acknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - as (string) — Role label of this responder. - - assigned_at (string) (required) — Unix timestamp (seconds) when the member was assigned. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - assigned_at (string) (required) — Unix timestamp (seconds) when the member was assigned. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - email (string) — Member email, filled by the server. - person_id (integer) (required) — Responder member ID. - person_name (string) — Member display name, filled by the server. - root_cause (string) (required) — Root cause analysis. - silence_url (string) (required) — Quick-silence URL for this incident. - - snoozed_before (string) (required) — Unix timestamp (seconds) until which notifications are snoozed. 0 if not snoozed. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. - - start_time (string) (required) — Unix timestamp (seconds) when the incident started. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - snoozed_before (string) (required) — Unix timestamp (seconds) until which notifications are snoozed. 0 if not snoozed. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. + - start_time (string) (required) — Unix timestamp (seconds) when the incident started. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - title (string) (required) — Incident title. - - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Args: optionalArg("incident_id"), Example: ` flashduty incident info --data '{"incident_id":"69da451ef77b1b51f40e83ee"}'`, @@ -1648,7 +1648,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - account_locale (string) (required) — Account locale. - account_name (string) (required) — Account name. - account_time_zone (string) (required) — Account time zone. - - ack_time (string) (required) — Unix timestamp (seconds) when the incident was first acknowledged. 0 if unacknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - ack_time (string) (required) — Unix timestamp (seconds) when the incident was first acknowledged. 0 if unacknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - active_alert_cnt (integer) (required) — Count of alerts currently in Critical/Warning/Info state. - ai_summary (string) (required) — AI-generated summary of the incident. - alert_cnt (integer) (required) — Total count of alerts merged into this incident. @@ -1662,35 +1662,35 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - channel_id (integer) (required) — Channel ID. - channel_name (string) (required) — Channel display name. - channel_status (string) (required) — Channel status. - - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) (required) — Deprecated. Use 'integration_id' instead. - data_source_name (string) (required) — Deprecated. Use 'integration_name'. - data_source_ref_id (string) (required) — Deprecated. Use 'integration_ref_id'. - data_source_type (string) — Deprecated. Use 'integration_type'. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Alert description. - - end_time (string) (required) — Unix timestamp (seconds) when the alert recovered. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - end_time (string) (required) — Unix timestamp (seconds) when the alert recovered. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - event_cnt (integer) (required) — Total number of raw events merged into this alert. - events (array) — Raw alert event preview, populated only when requested. Capped at the 20 newest events per alert. - account_id (integer) — Account ID. - alert_id (string) — Parent alert ID (MongoDB ObjectID). - alert_key (string) — Deduplication key used to merge events into an alert. - channel_id (integer) — Channel ID the event is routed to. - - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) — Deprecated. Use 'integration_id' instead. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) — Event description. - event_id (string) — Event ID (MongoDB ObjectID). - event_severity (string) — Severity of this event. [Critical, Warning, Info, Ok] - event_status (string) — Status of this event. [Critical, Warning, Info, Ok] - - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - images (array) — Images attached to the event. - integration_id (integer) — Integration that produced this event. - integration_type (string) — Type/plugin key of the integration that produced this event. - labels (object) — Label key-value pairs. - title (string) — Event title. - title_rule (string) — Title template used to derive 'title' from labels. - - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - ever_muted (boolean) (required) — Whether this alert has ever been silenced. - images (array) (required) — Attached images. - alt (string) — Alt text. @@ -1705,13 +1705,13 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - integration_ref_id (string) (required) — Integration reference ID. - integration_type (string) (required) — Integration type string. - labels (object) (required) — Alert labels. - - last_time (string) (required) — Unix timestamp (seconds) of the most recent event. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_time (string) (required) — Unix timestamp (seconds) of the most recent event. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - responder_email (string) (required) — Primary responder email, if any. - responder_name (string) (required) — Primary responder name, if any. - - start_time (string) (required) — Unix timestamp (seconds) when the alert first fired. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - start_time (string) (required) — Unix timestamp (seconds) when the alert first fired. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - title (string) (required) — Alert title. - title_rule (string) (required) — Title rendering rule. - - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - assigned_to (object) (required) — Current assignment target for the incident. - assigned_at (integer) — Unix timestamp (seconds) when the assignment was made. - emails (array) — Email recipients, used by integrations such as ServiceNow. @@ -1728,14 +1728,14 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - channel_id (integer) (required) — Channel ID. 0 for standalone incidents. - channel_name (string) (required) — Channel display name. - channel_status (string) (required) — Channel status. - - close_time (string) (required) — Unix timestamp (seconds) when the incident was closed. 0 if still open. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - close_time (string) (required) — Unix timestamp (seconds) when the incident was closed. 0 if still open. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - closer (object) — Closer member info. - as (string) — Role label for this member in the context of the current object. - email (string) — Member email address. - person_id (integer) — Member ID. - person_name (string) — Member display name. - closer_id (integer) (required) — Member ID that closed the incident. 0 if auto-closed. - - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator (object) — Creator member info. - as (string) — Role label for this member in the context of the current object. - email (string) — Member email address. @@ -1747,10 +1747,10 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - data_source_type (string) — Deprecated. Use 'integration_type' instead. - data_source_types (array) — Deprecated. Use 'integration_types' instead. - dedup_key (string) (required) — Deduplication key used to coalesce alerts. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Incident description. - detail_url (string) (required) — Web console URL for the incident. - - end_time (string) (required) — Unix timestamp (seconds) when the incident ended. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - end_time (string) (required) — Unix timestamp (seconds) when the incident ended. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - equals_md5 (string) (required) — MD5 hash used for content-equality checks. - ever_muted (boolean) (required) — Whether the incident has ever been silenced. - fields (object) (required) — Custom field values keyed by field name. @@ -1769,7 +1769,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - integration_type (string) — First alert's integration type string, used by the detail page for label mappings. - integration_types (array) (required) — Integration type strings for all contributing integrations. - labels (object) (required) — Labels propagated from alerts. - - last_time (string) (required) — Unix timestamp (seconds) of the most recent update. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_time (string) (required) — Unix timestamp (seconds) of the most recent update. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - links (array) — Channel-level link integrations rendered for this incident. - endpoint (string) (required) — Rendered URL for the link. - name (string) (required) — Display name of the link. @@ -1787,18 +1787,18 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - reporter_email (string) — Reporter email for manually created incidents. - resolution (string) (required) — Resolution notes. - responders (array) (required) — Current responders with assignment/acknowledgement state. - - acknowledged_at (string) (required) — Unix timestamp (seconds) when the member acknowledged. 0 if not yet acknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - acknowledged_at (string) (required) — Unix timestamp (seconds) when the member acknowledged. 0 if not yet acknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - as (string) — Role label of this responder. - - assigned_at (string) (required) — Unix timestamp (seconds) when the member was assigned. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - assigned_at (string) (required) — Unix timestamp (seconds) when the member was assigned. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - email (string) — Member email, filled by the server. - person_id (integer) (required) — Responder member ID. - person_name (string) — Member display name, filled by the server. - root_cause (string) (required) — Root cause analysis. - silence_url (string) (required) — Quick-silence URL for this incident. - - snoozed_before (string) (required) — Unix timestamp (seconds) until which notifications are snoozed. 0 if not snoozed. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. - - start_time (string) (required) — Unix timestamp (seconds) when the incident started. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - snoozed_before (string) (required) — Unix timestamp (seconds) until which notifications are snoozed. 0 if not snoozed. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. + - start_time (string) (required) — Unix timestamp (seconds) when the incident started. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - title (string) (required) — Incident title. - - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - search_after_ctx (string) — Opaque cursor to pass as 'search_after_ctx' on the next request. - total (integer) (required) — Total number of matching incidents. `, @@ -1947,7 +1947,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - account_locale (string) (required) — Account locale. - account_name (string) (required) — Account name. - account_time_zone (string) (required) — Account time zone. - - ack_time (string) (required) — Unix timestamp (seconds) when the incident was first acknowledged. 0 if unacknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - ack_time (string) (required) — Unix timestamp (seconds) when the incident was first acknowledged. 0 if unacknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - active_alert_cnt (integer) (required) — Count of alerts currently in Critical/Warning/Info state. - ai_summary (string) (required) — AI-generated summary of the incident. - alert_cnt (integer) (required) — Total count of alerts merged into this incident. @@ -1961,35 +1961,35 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - channel_id (integer) (required) — Channel ID. - channel_name (string) (required) — Channel display name. - channel_status (string) (required) — Channel status. - - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) (required) — Deprecated. Use 'integration_id' instead. - data_source_name (string) (required) — Deprecated. Use 'integration_name'. - data_source_ref_id (string) (required) — Deprecated. Use 'integration_ref_id'. - data_source_type (string) — Deprecated. Use 'integration_type'. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Alert description. - - end_time (string) (required) — Unix timestamp (seconds) when the alert recovered. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - end_time (string) (required) — Unix timestamp (seconds) when the alert recovered. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - event_cnt (integer) (required) — Total number of raw events merged into this alert. - events (array) — Raw alert event preview, populated only when requested. Capped at the 20 newest events per alert. - account_id (integer) — Account ID. - alert_id (string) — Parent alert ID (MongoDB ObjectID). - alert_key (string) — Deduplication key used to merge events into an alert. - channel_id (integer) — Channel ID the event is routed to. - - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) — Deprecated. Use 'integration_id' instead. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) — Event description. - event_id (string) — Event ID (MongoDB ObjectID). - event_severity (string) — Severity of this event. [Critical, Warning, Info, Ok] - event_status (string) — Status of this event. [Critical, Warning, Info, Ok] - - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - images (array) — Images attached to the event. - integration_id (integer) — Integration that produced this event. - integration_type (string) — Type/plugin key of the integration that produced this event. - labels (object) — Label key-value pairs. - title (string) — Event title. - title_rule (string) — Title template used to derive 'title' from labels. - - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - ever_muted (boolean) (required) — Whether this alert has ever been silenced. - images (array) (required) — Attached images. - alt (string) — Alt text. @@ -2004,13 +2004,13 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - integration_ref_id (string) (required) — Integration reference ID. - integration_type (string) (required) — Integration type string. - labels (object) (required) — Alert labels. - - last_time (string) (required) — Unix timestamp (seconds) of the most recent event. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_time (string) (required) — Unix timestamp (seconds) of the most recent event. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - responder_email (string) (required) — Primary responder email, if any. - responder_name (string) (required) — Primary responder name, if any. - - start_time (string) (required) — Unix timestamp (seconds) when the alert first fired. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - start_time (string) (required) — Unix timestamp (seconds) when the alert first fired. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - title (string) (required) — Alert title. - title_rule (string) (required) — Title rendering rule. - - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - assigned_to (object) (required) — Current assignment target for the incident. - assigned_at (integer) — Unix timestamp (seconds) when the assignment was made. - emails (array) — Email recipients, used by integrations such as ServiceNow. @@ -2027,14 +2027,14 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - channel_id (integer) (required) — Channel ID. 0 for standalone incidents. - channel_name (string) (required) — Channel display name. - channel_status (string) (required) — Channel status. - - close_time (string) (required) — Unix timestamp (seconds) when the incident was closed. 0 if still open. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - close_time (string) (required) — Unix timestamp (seconds) when the incident was closed. 0 if still open. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - closer (object) — Closer member info. - as (string) — Role label for this member in the context of the current object. - email (string) — Member email address. - person_id (integer) — Member ID. - person_name (string) — Member display name. - closer_id (integer) (required) — Member ID that closed the incident. 0 if auto-closed. - - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator (object) — Creator member info. - as (string) — Role label for this member in the context of the current object. - email (string) — Member email address. @@ -2046,10 +2046,10 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - data_source_type (string) — Deprecated. Use 'integration_type' instead. - data_source_types (array) — Deprecated. Use 'integration_types' instead. - dedup_key (string) (required) — Deduplication key used to coalesce alerts. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Incident description. - detail_url (string) (required) — Web console URL for the incident. - - end_time (string) (required) — Unix timestamp (seconds) when the incident ended. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - end_time (string) (required) — Unix timestamp (seconds) when the incident ended. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - equals_md5 (string) (required) — MD5 hash used for content-equality checks. - ever_muted (boolean) (required) — Whether the incident has ever been silenced. - fields (object) (required) — Custom field values keyed by field name. @@ -2068,7 +2068,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - integration_type (string) — First alert's integration type string, used by the detail page for label mappings. - integration_types (array) (required) — Integration type strings for all contributing integrations. - labels (object) (required) — Labels propagated from alerts. - - last_time (string) (required) — Unix timestamp (seconds) of the most recent update. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_time (string) (required) — Unix timestamp (seconds) of the most recent update. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - links (array) — Channel-level link integrations rendered for this incident. - endpoint (string) (required) — Rendered URL for the link. - name (string) (required) — Display name of the link. @@ -2086,18 +2086,18 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - reporter_email (string) — Reporter email for manually created incidents. - resolution (string) (required) — Resolution notes. - responders (array) (required) — Current responders with assignment/acknowledgement state. - - acknowledged_at (string) (required) — Unix timestamp (seconds) when the member acknowledged. 0 if not yet acknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - acknowledged_at (string) (required) — Unix timestamp (seconds) when the member acknowledged. 0 if not yet acknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - as (string) — Role label of this responder. - - assigned_at (string) (required) — Unix timestamp (seconds) when the member was assigned. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - assigned_at (string) (required) — Unix timestamp (seconds) when the member was assigned. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - email (string) — Member email, filled by the server. - person_id (integer) (required) — Responder member ID. - person_name (string) — Member display name, filled by the server. - root_cause (string) (required) — Root cause analysis. - silence_url (string) (required) — Quick-silence URL for this incident. - - snoozed_before (string) (required) — Unix timestamp (seconds) until which notifications are snoozed. 0 if not snoozed. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. - - start_time (string) (required) — Unix timestamp (seconds) when the incident started. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - snoozed_before (string) (required) — Unix timestamp (seconds) until which notifications are snoozed. 0 if not snoozed. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. + - start_time (string) (required) — Unix timestamp (seconds) when the incident started. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - title (string) (required) — Incident title. - - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - search_after_ctx (string) — Opaque cursor to pass as 'search_after_ctx' on the next request. - total (integer) (required) — Total number of matching incidents. `, @@ -2239,7 +2239,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - account_locale (string) (required) — Account locale. - account_name (string) (required) — Account name. - account_time_zone (string) (required) — Account time zone. - - ack_time (string) (required) — Unix timestamp (seconds) when the incident was first acknowledged. 0 if unacknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - ack_time (string) (required) — Unix timestamp (seconds) when the incident was first acknowledged. 0 if unacknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - active_alert_cnt (integer) (required) — Count of alerts currently in Critical/Warning/Info state. - ai_summary (string) (required) — AI-generated summary of the incident. - alert_cnt (integer) (required) — Total count of alerts merged into this incident. @@ -2253,35 +2253,35 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - channel_id (integer) (required) — Channel ID. - channel_name (string) (required) — Channel display name. - channel_status (string) (required) — Channel status. - - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) (required) — Deprecated. Use 'integration_id' instead. - data_source_name (string) (required) — Deprecated. Use 'integration_name'. - data_source_ref_id (string) (required) — Deprecated. Use 'integration_ref_id'. - data_source_type (string) — Deprecated. Use 'integration_type'. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Alert description. - - end_time (string) (required) — Unix timestamp (seconds) when the alert recovered. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - end_time (string) (required) — Unix timestamp (seconds) when the alert recovered. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - event_cnt (integer) (required) — Total number of raw events merged into this alert. - events (array) — Raw alert event preview, populated only when requested. Capped at the 20 newest events per alert. - account_id (integer) — Account ID. - alert_id (string) — Parent alert ID (MongoDB ObjectID). - alert_key (string) — Deduplication key used to merge events into an alert. - channel_id (integer) — Channel ID the event is routed to. - - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Record creation time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - data_source_id (integer) — Deprecated. Use 'integration_id' instead. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) — Event description. - event_id (string) — Event ID (MongoDB ObjectID). - event_severity (string) — Severity of this event. [Critical, Warning, Info, Ok] - event_status (string) — Status of this event. [Critical, Warning, Info, Ok] - - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - event_time (string) — Event timestamp, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - images (array) — Images attached to the event. - integration_id (integer) — Integration that produced this event. - integration_type (string) — Type/plugin key of the integration that produced this event. - labels (object) — Label key-value pairs. - title (string) — Event title. - title_rule (string) — Title template used to derive 'title' from labels. - - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Record update time, Unix epoch seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - ever_muted (boolean) (required) — Whether this alert has ever been silenced. - images (array) (required) — Attached images. - alt (string) — Alt text. @@ -2296,13 +2296,13 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - integration_ref_id (string) (required) — Integration reference ID. - integration_type (string) (required) — Integration type string. - labels (object) (required) — Alert labels. - - last_time (string) (required) — Unix timestamp (seconds) of the most recent event. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_time (string) (required) — Unix timestamp (seconds) of the most recent event. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - responder_email (string) (required) — Primary responder email, if any. - responder_name (string) (required) — Primary responder name, if any. - - start_time (string) (required) — Unix timestamp (seconds) when the alert first fired. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - start_time (string) (required) — Unix timestamp (seconds) when the alert first fired. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - title (string) (required) — Alert title. - title_rule (string) (required) — Title rendering rule. - - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - assigned_to (object) (required) — Current assignment target for the incident. - assigned_at (integer) — Unix timestamp (seconds) when the assignment was made. - emails (array) — Email recipients, used by integrations such as ServiceNow. @@ -2319,14 +2319,14 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - channel_id (integer) (required) — Channel ID. 0 for standalone incidents. - channel_name (string) (required) — Channel display name. - channel_status (string) (required) — Channel status. - - close_time (string) (required) — Unix timestamp (seconds) when the incident was closed. 0 if still open. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - close_time (string) (required) — Unix timestamp (seconds) when the incident was closed. 0 if still open. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - closer (object) — Closer member info. - as (string) — Role label for this member in the context of the current object. - email (string) — Member email address. - person_id (integer) — Member ID. - person_name (string) — Member display name. - closer_id (integer) (required) — Member ID that closed the incident. 0 if auto-closed. - - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator (object) — Creator member info. - as (string) — Role label for this member in the context of the current object. - email (string) — Member email address. @@ -2338,10 +2338,10 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - data_source_type (string) — Deprecated. Use 'integration_type' instead. - data_source_types (array) — Deprecated. Use 'integration_types' instead. - dedup_key (string) (required) — Deduplication key used to coalesce alerts. - - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Soft-delete timestamp (seconds). Zero if not deleted. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Incident description. - detail_url (string) (required) — Web console URL for the incident. - - end_time (string) (required) — Unix timestamp (seconds) when the incident ended. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - end_time (string) (required) — Unix timestamp (seconds) when the incident ended. 0 if still active. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - equals_md5 (string) (required) — MD5 hash used for content-equality checks. - ever_muted (boolean) (required) — Whether the incident has ever been silenced. - fields (object) (required) — Custom field values keyed by field name. @@ -2360,7 +2360,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - integration_type (string) — First alert's integration type string, used by the detail page for label mappings. - integration_types (array) (required) — Integration type strings for all contributing integrations. - labels (object) (required) — Labels propagated from alerts. - - last_time (string) (required) — Unix timestamp (seconds) of the most recent update. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - last_time (string) (required) — Unix timestamp (seconds) of the most recent update. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - links (array) — Channel-level link integrations rendered for this incident. - endpoint (string) (required) — Rendered URL for the link. - name (string) (required) — Display name of the link. @@ -2378,19 +2378,19 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - reporter_email (string) — Reporter email for manually created incidents. - resolution (string) (required) — Resolution notes. - responders (array) (required) — Current responders with assignment/acknowledgement state. - - acknowledged_at (string) (required) — Unix timestamp (seconds) when the member acknowledged. 0 if not yet acknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - acknowledged_at (string) (required) — Unix timestamp (seconds) when the member acknowledged. 0 if not yet acknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - as (string) — Role label of this responder. - - assigned_at (string) (required) — Unix timestamp (seconds) when the member was assigned. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - assigned_at (string) (required) — Unix timestamp (seconds) when the member was assigned. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - email (string) — Member email, filled by the server. - person_id (integer) (required) — Responder member ID. - person_name (string) — Member display name, filled by the server. - root_cause (string) (required) — Root cause analysis. - score (number) (required) — Similarity score from the vector search. - silence_url (string) (required) — Quick-silence URL for this incident. - - snoozed_before (string) (required) — Unix timestamp (seconds) until which notifications are snoozed. 0 if not snoozed. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. - - start_time (string) (required) — Unix timestamp (seconds) when the incident started. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - snoozed_before (string) (required) — Unix timestamp (seconds) until which notifications are snoozed. 0 if not snoozed. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. + - start_time (string) (required) — Unix timestamp (seconds) when the incident started. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - title (string) (required) — Incident title. - - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Args: requireBodyFieldOrExactArg("incident_id", "incident-id"), Example: ` flashduty incident past-list --data '{"incident_id":"69da451ef77b1b51f40e83ee","limit":5}'`, @@ -2503,9 +2503,9 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - incidents_latest_close_seconds (integer) (required) — Latest close time among linked incidents (seconds). - incidents_total_duration_seconds (integer) (required) — Cumulative duration in seconds. - responders (array) (required) — Responders involved in the incident(s). - - acknowledged_at (string) (required) — Unix timestamp (seconds) when the member acknowledged. 0 if not yet acknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - acknowledged_at (string) (required) — Unix timestamp (seconds) when the member acknowledged. 0 if not yet acknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - as (string) — Role label of this responder. - - assigned_at (string) (required) — Unix timestamp (seconds) when the member was assigned. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - assigned_at (string) (required) — Unix timestamp (seconds) when the member was assigned. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - email (string) — Member email, filled by the server. - person_id (integer) (required) — Responder member ID. - person_name (string) — Member display name, filled by the server. @@ -2517,7 +2517,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - author_ids (array) (required) — Member IDs that contributed to the report. - channel_id (integer) (required) — Owning channel ID. 0 if none. - channel_name (string) (required) — Channel name, filled by the server. - - created_at_seconds (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_seconds (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - generation (integer) (required) — Collaboration document generation. Incremented by each full content reset; 0 for legacy documents. - incident_ids (array) (required) — Linked incident IDs. - is_private (boolean) (required) — When true, only team members and admins can view. @@ -2528,7 +2528,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - team_id (integer) (required) — Owning team ID. 0 if none. - template_id (string) (required) — Template used to initialize the report. - title (string) (required) — Report title. - - updated_at_seconds (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_seconds (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Args: requireBodyFieldOrExactArg("post_mortem_id", "post-mortem-id"), RunE: func(cmd *cobra.Command, args []string) error { @@ -2602,7 +2602,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - author_ids (array) (required) — Member IDs that contributed to the report. - channel_id (integer) (required) — Owning channel ID. 0 if none. - channel_name (string) (required) — Channel name, filled by the server. - - created_at_seconds (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_seconds (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - generation (integer) (required) — Collaboration document generation. Incremented by each full content reset; 0 for legacy documents. - incident_ids (array) (required) — Linked incident IDs. - is_private (boolean) (required) — When true, only team members and admins can view. @@ -2613,7 +2613,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - team_id (integer) (required) — Owning team ID. 0 if none. - template_id (string) (required) — Template used to initialize the report. - title (string) (required) — Report title. - - updated_at_seconds (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_seconds (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - search_after_ctx (string) — Cursor for forward pagination. - total (integer) (required) — Total matching reports. `, @@ -3394,7 +3394,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - items (array) (required) — War room records. - account_id (integer) (required) — Account ID. - chat_id (string) (required) — Chat/group ID on the IM side. - - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID that created the war room. - incident_id (string) (required) — Associated incident ID (MongoDB ObjectID). - integration_id (integer) (required) — IM integration ID. @@ -3462,9 +3462,9 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - idempotent_replay (boolean) — True when the call replayed an earlier request with the same idempotency key. - items (array) (required) — Work items for the current page. - assignee_ids (array) (required) — Member IDs of the current assignees. Never null; an empty array means unassigned. - - converted_at_seconds (string) — Conversion time as a Unix timestamp in seconds. Present only after conversion. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - converted_at_seconds (string) — Conversion time as a Unix timestamp in seconds. Present only after conversion. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - converted_by (integer) — Member ID of the operator who converted the action into a follow-up. Present only after conversion. - - created_at_seconds (string) (required) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_seconds (string) (required) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID of the creator. - description (string) — Optional longer description (max 65,535 characters). (≤65535 chars) - incident_id (string) (required) — Incident ID (MongoDB ObjectID) the item is anchored to. @@ -3475,7 +3475,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - source_kind (string) (required) — 'native' for items created through this API; 'legacy_follow_up' for items migrated from legacy post-mortem follow-ups. [native, legacy_follow_up] - status (string) (required) — Client-defined status (max 64 characters). There is no fixed state machine. (≤64 chars) - title (string) (required) — Item title (max 512 characters). (≤512 chars) - - updated_at_seconds (string) (required) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_seconds (string) (required) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Member ID of the last updater. - version (integer) (required) — Optimistic-locking version, incremented on every mutation. - work_item_id (string) (required) — Work item ID (opaque string, max 128 characters). (≤128 chars) @@ -3544,9 +3544,9 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - idempotent_replay (boolean) — True when the call replayed an earlier request with the same idempotency key. - item (object) — A structured incident work item (action or post-mortem follow-up) with its assignees. - assignee_ids (array) (required) — Member IDs of the current assignees. Never null; an empty array means unassigned. - - converted_at_seconds (string) — Conversion time as a Unix timestamp in seconds. Present only after conversion. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - converted_at_seconds (string) — Conversion time as a Unix timestamp in seconds. Present only after conversion. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - converted_by (integer) — Member ID of the operator who converted the action into a follow-up. Present only after conversion. - - created_at_seconds (string) (required) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_seconds (string) (required) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID of the creator. - description (string) — Optional longer description (max 65,535 characters). (≤65535 chars) - incident_id (string) (required) — Incident ID (MongoDB ObjectID) the item is anchored to. @@ -3557,7 +3557,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - source_kind (string) (required) — 'native' for items created through this API; 'legacy_follow_up' for items migrated from legacy post-mortem follow-ups. [native, legacy_follow_up] - status (string) (required) — Client-defined status (max 64 characters). There is no fixed state machine. (≤64 chars) - title (string) (required) — Item title (max 512 characters). (≤512 chars) - - updated_at_seconds (string) (required) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_seconds (string) (required) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Member ID of the last updater. - version (integer) (required) — Optimistic-locking version, incremented on every mutation. - work_item_id (string) (required) — Work item ID (opaque string, max 128 characters). (≤128 chars) @@ -3634,9 +3634,9 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - idempotent_replay (boolean) — True when the call replayed an earlier request with the same idempotency key. - item (object) — A structured incident work item (action or post-mortem follow-up) with its assignees. - assignee_ids (array) (required) — Member IDs of the current assignees. Never null; an empty array means unassigned. - - converted_at_seconds (string) — Conversion time as a Unix timestamp in seconds. Present only after conversion. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - converted_at_seconds (string) — Conversion time as a Unix timestamp in seconds. Present only after conversion. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - converted_by (integer) — Member ID of the operator who converted the action into a follow-up. Present only after conversion. - - created_at_seconds (string) (required) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_seconds (string) (required) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID of the creator. - description (string) — Optional longer description (max 65,535 characters). (≤65535 chars) - incident_id (string) (required) — Incident ID (MongoDB ObjectID) the item is anchored to. @@ -3647,7 +3647,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - source_kind (string) (required) — 'native' for items created through this API; 'legacy_follow_up' for items migrated from legacy post-mortem follow-ups. [native, legacy_follow_up] - status (string) (required) — Client-defined status (max 64 characters). There is no fixed state machine. (≤64 chars) - title (string) (required) — Item title (max 512 characters). (≤512 chars) - - updated_at_seconds (string) (required) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_seconds (string) (required) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Member ID of the last updater. - version (integer) (required) — Optimistic-locking version, incremented on every mutation. - work_item_id (string) (required) — Work item ID (opaque string, max 128 characters). (≤128 chars) @@ -3734,9 +3734,9 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - idempotent_replay (boolean) — True when the call replayed an earlier request with the same idempotency key and no new item was created. - item (object) (required) — A structured incident work item (action or post-mortem follow-up) with its assignees. - assignee_ids (array) (required) — Member IDs of the current assignees. Never null; an empty array means unassigned. - - converted_at_seconds (string) — Conversion time as a Unix timestamp in seconds. Present only after conversion. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - converted_at_seconds (string) — Conversion time as a Unix timestamp in seconds. Present only after conversion. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - converted_by (integer) — Member ID of the operator who converted the action into a follow-up. Present only after conversion. - - created_at_seconds (string) (required) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_seconds (string) (required) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID of the creator. - description (string) — Optional longer description (max 65,535 characters). (≤65535 chars) - incident_id (string) (required) — Incident ID (MongoDB ObjectID) the item is anchored to. @@ -3747,7 +3747,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - source_kind (string) (required) — 'native' for items created through this API; 'legacy_follow_up' for items migrated from legacy post-mortem follow-ups. [native, legacy_follow_up] - status (string) (required) — Client-defined status (max 64 characters). There is no fixed state machine. (≤64 chars) - title (string) (required) — Item title (max 512 characters). (≤512 chars) - - updated_at_seconds (string) (required) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_seconds (string) (required) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Member ID of the last updater. - version (integer) (required) — Optimistic-locking version, incremented on every mutation. - work_item_id (string) (required) — Work item ID (opaque string, max 128 characters). (≤128 chars) @@ -3905,9 +3905,9 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - idempotent_replay (boolean) — True when the call replayed an earlier request with the same idempotency key. - items (array) (required) — Work items for the current page. - assignee_ids (array) (required) — Member IDs of the current assignees. Never null; an empty array means unassigned. - - converted_at_seconds (string) — Conversion time as a Unix timestamp in seconds. Present only after conversion. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - converted_at_seconds (string) — Conversion time as a Unix timestamp in seconds. Present only after conversion. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - converted_by (integer) — Member ID of the operator who converted the action into a follow-up. Present only after conversion. - - created_at_seconds (string) (required) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_seconds (string) (required) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID of the creator. - description (string) — Optional longer description (max 65,535 characters). (≤65535 chars) - incident_id (string) (required) — Incident ID (MongoDB ObjectID) the item is anchored to. @@ -3918,7 +3918,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - source_kind (string) (required) — 'native' for items created through this API; 'legacy_follow_up' for items migrated from legacy post-mortem follow-ups. [native, legacy_follow_up] - status (string) (required) — Client-defined status (max 64 characters). There is no fixed state machine. (≤64 chars) - title (string) (required) — Item title (max 512 characters). (≤512 chars) - - updated_at_seconds (string) (required) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_seconds (string) (required) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Member ID of the last updater. - version (integer) (required) — Optimistic-locking version, incremented on every mutation. - work_item_id (string) (required) — Work item ID (opaque string, max 128 characters). (≤128 chars) @@ -3997,9 +3997,9 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - idempotent_replay (boolean) — True when the call replayed an earlier request with the same idempotency key. - item (object) — A structured incident work item (action or post-mortem follow-up) with its assignees. - assignee_ids (array) (required) — Member IDs of the current assignees. Never null; an empty array means unassigned. - - converted_at_seconds (string) — Conversion time as a Unix timestamp in seconds. Present only after conversion. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - converted_at_seconds (string) — Conversion time as a Unix timestamp in seconds. Present only after conversion. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - converted_by (integer) — Member ID of the operator who converted the action into a follow-up. Present only after conversion. - - created_at_seconds (string) (required) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_seconds (string) (required) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID of the creator. - description (string) — Optional longer description (max 65,535 characters). (≤65535 chars) - incident_id (string) (required) — Incident ID (MongoDB ObjectID) the item is anchored to. @@ -4010,7 +4010,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - source_kind (string) (required) — 'native' for items created through this API; 'legacy_follow_up' for items migrated from legacy post-mortem follow-ups. [native, legacy_follow_up] - status (string) (required) — Client-defined status (max 64 characters). There is no fixed state machine. (≤64 chars) - title (string) (required) — Item title (max 512 characters). (≤512 chars) - - updated_at_seconds (string) (required) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_seconds (string) (required) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Member ID of the last updater. - version (integer) (required) — Optimistic-locking version, incremented on every mutation. - work_item_id (string) (required) — Work item ID (opaque string, max 128 characters). (≤128 chars) @@ -4087,9 +4087,9 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - idempotent_replay (boolean) — True when the call replayed an earlier request with the same idempotency key. - item (object) — A structured incident work item (action or post-mortem follow-up) with its assignees. - assignee_ids (array) (required) — Member IDs of the current assignees. Never null; an empty array means unassigned. - - converted_at_seconds (string) — Conversion time as a Unix timestamp in seconds. Present only after conversion. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - converted_at_seconds (string) — Conversion time as a Unix timestamp in seconds. Present only after conversion. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - converted_by (integer) — Member ID of the operator who converted the action into a follow-up. Present only after conversion. - - created_at_seconds (string) (required) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_seconds (string) (required) — Creation time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID of the creator. - description (string) — Optional longer description (max 65,535 characters). (≤65535 chars) - incident_id (string) (required) — Incident ID (MongoDB ObjectID) the item is anchored to. @@ -4100,7 +4100,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - source_kind (string) (required) — 'native' for items created through this API; 'legacy_follow_up' for items migrated from legacy post-mortem follow-ups. [native, legacy_follow_up] - status (string) (required) — Client-defined status (max 64 characters). There is no fixed state machine. (≤64 chars) - title (string) (required) — Item title (max 512 characters). (≤512 chars) - - updated_at_seconds (string) (required) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_seconds (string) (required) — Last update time as a Unix timestamp in seconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Member ID of the last updater. - version (integer) (required) — Optimistic-locking version, incremented on every mutation. - work_item_id (string) (required) — Work item ID (opaque string, max 128 characters). (≤128 chars) @@ -4188,12 +4188,12 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - account_id (integer) (required) — Account ID that owns the template. 0 for built-in templates. - content (string) (required) — BlockNote JSON content used to initialize the report body. - content_markdown (string) (required) — Markdown version of the template content, used by AI generation. - - created_at_seconds (string) (required) — Unix timestamp in seconds when the template was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_seconds (string) (required) — Unix timestamp in seconds when the template was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Template description. - name (string) (required) — Template name shown in the console. - team_id (integer) (required) — Managing team ID. Built-in templates use 0. - template_id (string) (required) — Template ID. Built-in templates use a stable 'post_mortem_default_tmpl_*' ID. - - updated_at_seconds (string) (required) — Unix timestamp in seconds when the template was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_seconds (string) (required) — Unix timestamp in seconds when the template was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - search_after_ctx (string) — Cursor for forward pagination. - total (integer) (required) — Total matching templates. `, @@ -4261,12 +4261,12 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - account_id (integer) (required) — Account ID that owns the template. 0 for built-in templates. - content (string) (required) — BlockNote JSON content used to initialize the report body. - content_markdown (string) (required) — Markdown version of the template content, used by AI generation. - - created_at_seconds (string) (required) — Unix timestamp in seconds when the template was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_seconds (string) (required) — Unix timestamp in seconds when the template was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Template description. - name (string) (required) — Template name shown in the console. - team_id (integer) (required) — Managing team ID. Built-in templates use 0. - template_id (string) (required) — Template ID. Built-in templates use a stable 'post_mortem_default_tmpl_*' ID. - - updated_at_seconds (string) (required) — Unix timestamp in seconds when the template was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_seconds (string) (required) — Unix timestamp in seconds when the template was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Args: requireBodyFieldOrExactArg("template_id", "template-id"), RunE: func(cmd *cobra.Command, args []string) error { @@ -4376,9 +4376,9 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - incidents_latest_close_seconds (integer) (required) — Latest close time among linked incidents (seconds). - incidents_total_duration_seconds (integer) (required) — Cumulative duration in seconds. - responders (array) (required) — Responders involved in the incident(s). - - acknowledged_at (string) (required) — Unix timestamp (seconds) when the member acknowledged. 0 if not yet acknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - acknowledged_at (string) (required) — Unix timestamp (seconds) when the member acknowledged. 0 if not yet acknowledged. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - as (string) — Role label of this responder. - - assigned_at (string) (required) — Unix timestamp (seconds) when the member was assigned. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - assigned_at (string) (required) — Unix timestamp (seconds) when the member was assigned. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - email (string) — Member email, filled by the server. - person_id (integer) (required) — Responder member ID. - person_name (string) — Member display name, filled by the server. @@ -4390,7 +4390,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - author_ids (array) (required) — Member IDs that contributed to the report. - channel_id (integer) (required) — Owning channel ID. 0 if none. - channel_name (string) (required) — Channel name, filled by the server. - - created_at_seconds (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_seconds (string) (required) — Creation timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - generation (integer) (required) — Collaboration document generation. Incremented by each full content reset; 0 for legacy documents. - incident_ids (array) (required) — Linked incident IDs. - is_private (boolean) (required) — When true, only team members and admins can view. @@ -4401,7 +4401,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - team_id (integer) (required) — Owning team ID. 0 if none. - template_id (string) (required) — Template used to initialize the report. - title (string) (required) — Report title. - - updated_at_seconds (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_seconds (string) (required) — Last update timestamp (seconds). CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Args: requireBodyFieldOrArgs("incident_ids", "incident-ids"), Example: ` flashduty incident post-mortem-init --data '{"incident_ids":["69bb9233331067560c718ecd"],"template_id":"post_mortem_default_tmpl_en-us"}'`, @@ -4733,12 +4733,12 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - account_id (integer) (required) — Account ID that owns the template. 0 for built-in templates. - content (string) (required) — BlockNote JSON content used to initialize the report body. - content_markdown (string) (required) — Markdown version of the template content, used by AI generation. - - created_at_seconds (string) (required) — Unix timestamp in seconds when the template was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_seconds (string) (required) — Unix timestamp in seconds when the template was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Template description. - name (string) (required) — Template name shown in the console. - team_id (integer) (required) — Managing team ID. Built-in templates use 0. - template_id (string) (required) — Template ID. Built-in templates use a stable 'post_mortem_default_tmpl_*' ID. - - updated_at_seconds (string) (required) — Unix timestamp in seconds when the template was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_seconds (string) (required) — Unix timestamp in seconds when the template was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Example: ` flashduty incident post-mortem-template-upsert --data '{"content":"[{\"type\":\"heading\",\"content\":\"Summary\"}]","content_markdown":"## Summary\nDescribe what happened.","description":"Template for production incident reviews.","name":"Production incident template","team_id":2477033058131}'`, RunE: func(cmd *cobra.Command, args []string) error { diff --git a/internal/cli/zz_generated_issue_preset_severity_rules.go b/internal/cli/zz_generated_issue_preset_severity_rules.go index 7de14b9..d5ab680 100644 --- a/internal/cli/zz_generated_issue_preset_severity_rules.go +++ b/internal/cli/zz_generated_issue_preset_severity_rules.go @@ -276,9 +276,9 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - rules (array) (required) — Full rule set captured immediately before the mutation that produced this snapshot. Empty for the very first snapshot. - account_id (integer) (required) — Account ID the rule belongs to. - application_id (string) (required) — RUM application ID the rule belongs to. - - created_at (string) (required) — Unix timestamp in milliseconds when the rule was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Unix timestamp in milliseconds when the rule was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID who originally created the rule. - - deleted_at (string) (required) — Unix timestamp in milliseconds the rule was soft-deleted; '0' means not deleted. Always '0' in practice, since deleted rules are excluded before a snapshot is taken. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) (required) — Unix timestamp in milliseconds the rule was soft-deleted; '0' means not deleted. Always '0' in practice, since deleted rules are excluded before a snapshot is taken. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Rule description. May be empty. - filters (array>) (required) — OR-of-ANDs filter structure: the outer array is OR'd, each inner array is AND'd. A rule matches an error when at least one inner AND-group fully matches. - key (string) (required) — Filter attribute key. Only these Error-level attributes are supported for preset severity rules. | Value | Meaning | |---|---| | 'error.usr_id' | User ID | | 'error.usr_email' | User email | | 'error.view_url' | Full URL of the page where the error occurred | | 'error.view_url_path' | URL path of the page where the error occurred | | 'error.error_type' | Error type | | 'error.error_message' | Error message | | 'error.env' | Environment (e.g. production/staging) | | 'error.service' | Service name | | 'error.device_type' | Device type | | 'error.os_name' | Operating system name | | 'error.browser_name' | Browser name | | 'error.is_crash' | Whether the error is a crash (boolean) | [error.usr_id, error.usr_email, error.view_url, error.view_url_path, error.error_type, error.error_message, error.env, error.service, error.device_type, error.os_name, error.browser_name, error.is_crash] @@ -290,9 +290,9 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - rule_name (string) (required) — Rule display name. - severity (string) (required) — Severity assigned to errors matching this rule. [Critical, Warning, Info] - status (string) (required) — Rule status at snapshot time. [enabled, disabled] - - updated_at (string) (required) — Unix timestamp in milliseconds when the rule was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Unix timestamp in milliseconds when the rule was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Member ID who last updated the rule as of snapshot time. - - updated_at (string) (required) — Unix timestamp in milliseconds when the snapshot was written. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Unix timestamp in milliseconds when the snapshot was written. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Member ID who triggered the mutation this snapshot precedes. - updated_by_name (string) (required) — Display name of 'updated_by' at the time of the change. - version (integer) (required) — Monotonically increasing snapshot version number, starting at 1. @@ -426,7 +426,7 @@ Request fields: Response fields ('data' envelope is unwrapped — rows are nested under items[]; pipe 'jq '.items[]'', NOT '.data.items[]'): - items (array) (required) — Rules ordered by evaluation order ('priority' ascending, then 'created_at' ascending). - - created_at (string) (required) — Unix timestamp in milliseconds when the rule was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Unix timestamp in milliseconds when the rule was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Rule description. May be empty. - filters (array>) (required) — OR-of-ANDs filter structure: the outer array is OR'd, each inner array is AND'd. A rule matches an error when at least one inner AND-group fully matches. - key (string) (required) — Filter attribute key. Only these Error-level attributes are supported for preset severity rules. | Value | Meaning | |---|---| | 'error.usr_id' | User ID | | 'error.usr_email' | User email | | 'error.view_url' | Full URL of the page where the error occurred | | 'error.view_url_path' | URL path of the page where the error occurred | | 'error.error_type' | Error type | | 'error.error_message' | Error message | | 'error.env' | Environment (e.g. production/staging) | | 'error.service' | Service name | | 'error.device_type' | Device type | | 'error.os_name' | Operating system name | | 'error.browser_name' | Browser name | | 'error.is_crash' | Whether the error is a crash (boolean) | [error.usr_id, error.usr_email, error.view_url, error.view_url_path, error.error_type, error.error_message, error.env, error.service, error.device_type, error.os_name, error.browser_name, error.is_crash] @@ -437,7 +437,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - rule_name (string) (required) — Rule display name. - severity (string) (required) — Severity assigned to errors matching this rule. [Critical, Warning, Info] - status (string) (required) — Only enabled rules are evaluated against incoming errors. [enabled, disabled] - - updated_at (string) (required) — Unix timestamp in milliseconds when the rule was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Unix timestamp in milliseconds when the rule was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Args: requireBodyFieldOrExactArg("application_id", "application-id"), Example: ` flashduty rum issue-preset-severity-rules-list --data '{"application_id":"WoyQQ3BohkdtPivubEvE8o"}'`, diff --git a/internal/cli/zz_generated_issues.go b/internal/cli/zz_generated_issues.go index 2c033a1..db9f4f5 100644 --- a/internal/cli/zz_generated_issues.go +++ b/internal/cli/zz_generated_issues.go @@ -27,24 +27,24 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - age (integer) — Time span between the first and most recent occurrence, in seconds. Note: the struct comment at 'model/issue/issue.go:40' says millisecond, but the value is computed and consumed (severity rules) in seconds — the comment is stale. - application_id (string) — ID of the RUM application this issue belongs to. - application_name (string) — Name of the owning application, resolved by 'application_id' at query time (reflects the application's current name). - - created_at (string) — Issue creation time (client time of the first error event), Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Issue creation time (client time of the first error event), Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - error (object) — Representative error of this issue, taken from the error event that created it. - message (string) — Normalized error message, truncated to at most 512 characters. - type (string) — Error type, from the error event's 'error_type' field as reported by the SDK. - error_count (integer) — Total error occurrences. - first_seen (object) — Information about the issue's first occurrence (time and application version). - - timestamp (string) — Client time of the first error event, Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - timestamp (string) — Client time of the first error event, Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - version (string) — Application version at first occurrence; empty string when the event carries no version. - is_crash (boolean) — Whether the error caused an app crash. - issue_id (string) — Unique issue ID. - last_seen (object) — Information about the issue's most recent occurrence (time and application version). - - timestamp (string) — Client time of the most recent error event, Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - timestamp (string) — Client time of the most recent error event, Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - version (string) — Application version at the most recent occurrence; empty string when the event carries no version. - regression (object) — Regression metadata. Present only when a previously resolved issue re-occurred. - - regressed_at (string) — Timestamp when the regression was detected. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - regressed_at (string) — Timestamp when the regression was detected. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - regressed_at_version (string) — Application version in which the regression was observed. - - resolved_at (string) — When the issue was resolved before this regression, as a Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. - - resolved_at (string) — Time the issue was marked resolved, Unix timestamp in milliseconds; 0 while unresolved. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - resolved_at (string) — When the issue was resolved before this regression, as a Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. + - resolved_at (string) — Time the issue was marked resolved, Unix timestamp in milliseconds; 0 while unresolved. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - resolved_by (integer) — Person ID of the user who marked the issue resolved; 0 while unresolved. - service (string) — Name of the service that produced this issue, taken from the error event's 'service' field. - session_count (integer) — Affected user sessions. @@ -56,7 +56,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - source (string) — Origin of the cause: 'auto' for system-determined, 'user' for manually set. [auto, user] - value (string) — Suspected cause category. One of: | Value | Meaning | |---|---| | 'api.failed_request' | API request failure (e.g. HTTP 4xx/5xx responses) | | 'network.error' | Network connectivity error (offline, aborted requests, etc.) | | 'code.exception' | Code exception (Syntax/Reference/Range and similar runtime errors) | | 'code.invalid_object_access' | Invalid object access (e.g. reading a property of 'undefined'/'null') | | 'code.invalid_argument' | Invalid argument passed to a function | | 'unknown' | Cause could not be determined | [api.failed_request, network.error, code.exception, code.invalid_object_access, code.invalid_argument, unknown] - team_id (integer) — ID of the team owning this issue, copied from the owning application's 'team_id' at issue creation. - - updated_at (string) — Time the issue was last updated, Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Time the issue was last updated, Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - versions (array) — Deduplicated list of application versions in which this issue has occurred; may contain an empty string for events without version info. `, Args: requireBodyFieldOrExactArg("issue_id", "issue-id"), @@ -141,24 +141,24 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - age (integer) — Time span between the first and most recent occurrence, in seconds. Note: the struct comment at 'model/issue/issue.go:40' says millisecond, but the value is computed and consumed (severity rules) in seconds — the comment is stale. - application_id (string) — ID of the RUM application this issue belongs to. - application_name (string) — Name of the owning application, resolved by 'application_id' at query time (reflects the application's current name). - - created_at (string) — Issue creation time (client time of the first error event), Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) — Issue creation time (client time of the first error event), Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - error (object) — Representative error of this issue, taken from the error event that created it. - message (string) — Normalized error message, truncated to at most 512 characters. - type (string) — Error type, from the error event's 'error_type' field as reported by the SDK. - error_count (integer) — Total error occurrences. - first_seen (object) — Information about the issue's first occurrence (time and application version). - - timestamp (string) — Client time of the first error event, Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - timestamp (string) — Client time of the first error event, Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - version (string) — Application version at first occurrence; empty string when the event carries no version. - is_crash (boolean) — Whether the error caused an app crash. - issue_id (string) — Unique issue ID. - last_seen (object) — Information about the issue's most recent occurrence (time and application version). - - timestamp (string) — Client time of the most recent error event, Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - timestamp (string) — Client time of the most recent error event, Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - version (string) — Application version at the most recent occurrence; empty string when the event carries no version. - regression (object) — Regression metadata. Present only when a previously resolved issue re-occurred. - - regressed_at (string) — Timestamp when the regression was detected. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - regressed_at (string) — Timestamp when the regression was detected. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - regressed_at_version (string) — Application version in which the regression was observed. - - resolved_at (string) — When the issue was resolved before this regression, as a Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. - - resolved_at (string) — Time the issue was marked resolved, Unix timestamp in milliseconds; 0 while unresolved. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - resolved_at (string) — When the issue was resolved before this regression, as a Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. + - resolved_at (string) — Time the issue was marked resolved, Unix timestamp in milliseconds; 0 while unresolved. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - resolved_by (integer) — Person ID of the user who marked the issue resolved; 0 while unresolved. - service (string) — Name of the service that produced this issue, taken from the error event's 'service' field. - session_count (integer) — Affected user sessions. @@ -170,7 +170,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - source (string) — Origin of the cause: 'auto' for system-determined, 'user' for manually set. [auto, user] - value (string) — Suspected cause category. One of: | Value | Meaning | |---|---| | 'api.failed_request' | API request failure (e.g. HTTP 4xx/5xx responses) | | 'network.error' | Network connectivity error (offline, aborted requests, etc.) | | 'code.exception' | Code exception (Syntax/Reference/Range and similar runtime errors) | | 'code.invalid_object_access' | Invalid object access (e.g. reading a property of 'undefined'/'null') | | 'code.invalid_argument' | Invalid argument passed to a function | | 'unknown' | Cause could not be determined | [api.failed_request, network.error, code.exception, code.invalid_object_access, code.invalid_argument, unknown] - team_id (integer) — ID of the team owning this issue, copied from the owning application's 'team_id' at issue creation. - - updated_at (string) — Time the issue was last updated, Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) — Time the issue was last updated, Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - versions (array) — Deduplicated list of application versions in which this issue has occurred; may contain an empty string for events without version info. - total (integer) — Total number of issues matching the filter conditions. `, diff --git a/internal/cli/zz_generated_knowledge.go b/internal/cli/zz_generated_knowledge.go index 5e4c980..8ffecfa 100644 --- a/internal/cli/zz_generated_knowledge.go +++ b/internal/cli/zz_generated_knowledge.go @@ -34,7 +34,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - pack_id (string) (required) — ID of the knowledge pack that contains the file. - rel_path (string) (required) — Path relative to the pack root, e.g. 'runbooks/restart.md'. - size_bytes (integer) (required) — File size in bytes. - - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the file was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the file was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Person ID of the member who last modified the file. `, Example: ` flashduty safari knowledge-file-get --data '{"rel_path":"tmp/openapi-example.md"}'`, @@ -99,7 +99,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - pack_id (string) (required) — ID of the knowledge pack that contains the file. - rel_path (string) (required) — Path relative to the pack root, e.g. 'runbooks/restart.md'. - size_bytes (integer) (required) — File size in bytes. - - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the file was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the file was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Person ID of the member who last modified the file. - total (integer) (required) — Total number of files in the pack. `, @@ -235,7 +235,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - pack_id (string) (required) — ID of the knowledge pack that contains the file. - rel_path (string) (required) — Path relative to the pack root, e.g. 'runbooks/restart.md'. - size_bytes (integer) (required) — File size in bytes. - - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the file was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the file was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Person ID of the member who last modified the file. - warnings (array) — Non-blocking warnings after a successful write; 'code=unresolved_reference' means an @ref in the file content points to a file that does not exist in the pack. Absent when there are no warnings (omitempty). - code (string) (required) — Warning code. One of: 'unresolved_reference' (an @ref in the written file's content points to a file that does not exist in the pack; 'ref' carries it), 'still_referenced_by' (the deleted file is still @ref-referenced by other files in the pack; 'refs' lists the referrers). [unresolved_reference, still_referenced_by] @@ -302,12 +302,12 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - pack_id (string) (required) — ID of the knowledge pack that contains the file. - rel_path (string) (required) — Path relative to the pack root, e.g. 'runbooks/restart.md'. - size_bytes (integer) (required) — File size in bytes. - - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the file was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the file was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Person ID of the member who last modified the file. - pack (object) (required) — A knowledge pack — a versioned file tree staged into every AI SRE sandbox at session start. One pack exists per (account, scope, scope_id). - account_id (integer) (required) — Account that owns the pack. - can_edit (boolean) (required) — Whether the caller can edit this pack. - - created_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Person ID of the member who created the pack. - file_count (integer) (required) — Number of files in the pack. - pack_id (string) (required) — Knowledge pack ID ('kpk_' prefix). @@ -315,7 +315,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - scope_id (integer) (required) — Scope owner: the account ID for 'account' scope, the team ID for 'team' scope. - team_name (string) — Display name of the owning team (team scope only); empty for account scope. - total_bytes (integer) (required) — Total size of all files in bytes. - - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - version (integer) (required) — Pack version, incremented on every file change. `, Example: ` flashduty safari knowledge-get --data '{}'`, @@ -371,7 +371,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - packs (array) (required) — Array of visible knowledge packs after filtering (current page), used with 'total' for pagination. - account_id (integer) (required) — Account that owns the pack. - can_edit (boolean) (required) — Whether the caller can edit this pack. - - created_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Person ID of the member who created the pack. - file_count (integer) (required) — Number of files in the pack. - pack_id (string) (required) — Knowledge pack ID ('kpk_' prefix). @@ -379,7 +379,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - scope_id (integer) (required) — Scope owner: the account ID for 'account' scope, the team ID for 'team' scope. - team_name (string) — Display name of the owning team (team scope only); empty for account scope. - total_bytes (integer) (required) — Total size of all files in bytes. - - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - version (integer) (required) — Pack version, incremented on every file change. - total (integer) (required) — Total number of packs after filtering, before pagination. `, @@ -507,7 +507,7 @@ Request fields: Response fields ('data' envelope is unwrapped — these fields are at the top level): - account_id (integer) (required) — Account that owns the pack. - can_edit (boolean) (required) — Whether the caller can edit this pack. - - created_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Person ID of the member who created the pack. - file_count (integer) (required) — Number of files in the pack. - pack_id (string) (required) — Knowledge pack ID ('kpk_' prefix). @@ -515,7 +515,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - scope_id (integer) (required) — Scope owner: the account ID for 'account' scope, the team ID for 'team' scope. - team_name (string) — Display name of the owning team (team scope only); empty for account scope. - total_bytes (integer) (required) — Total size of all files in bytes. - - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - version (integer) (required) — Pack version, incremented on every file change. `, Example: ` flashduty safari knowledge-pack-ensure --data '{"scope":"team","scope_id":2477033058131}'`, @@ -573,7 +573,7 @@ Request fields: Response fields ('data' envelope is unwrapped — these fields are at the top level): - account_id (integer) (required) — Account that owns the pack. - can_edit (boolean) (required) — Whether the caller can edit this pack. - - created_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Person ID of the member who created the pack. - file_count (integer) (required) — Number of files in the pack. - pack_id (string) (required) — Knowledge pack ID ('kpk_' prefix). @@ -581,7 +581,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - scope_id (integer) (required) — Scope owner: the account ID for 'account' scope, the team ID for 'team' scope. - team_name (string) — Display name of the owning team (team scope only); empty for account scope. - total_bytes (integer) (required) — Total size of all files in bytes. - - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at_ms (string) (required) — Unix timestamp in milliseconds when the pack was last modified. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - version (integer) (required) — Pack version, incremented on every file change. `, Args: requireBodyFieldOrExactArg("pack_id", "pack-id"), diff --git a/internal/cli/zz_generated_licenses.go b/internal/cli/zz_generated_licenses.go index 7e37315..627ad7c 100644 --- a/internal/cli/zz_generated_licenses.go +++ b/internal/cli/zz_generated_licenses.go @@ -17,11 +17,11 @@ API: POST /oncall/license/list (oncall-license-read-license-list) Response fields ('data' envelope is unwrapped — rows are nested under items[]; pipe 'jq '.items[]'', NOT '.data.items[]'): - items (array) (required) — People holding an active license. - - created_at (string) (required) — Unix timestamp when a fixed license was assigned. '0' for temporary licenses. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Unix timestamp when a fixed license was assigned. '0' for temporary licenses. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - person_id (integer) (required) — ID of the licensed person. - person_name (string) (required) — Display name of the licensed person. - type (string) (required) — License assignment type. 'fixed' is explicitly assigned; 'temporary' is held from the active license window. [fixed, temporary] - - updated_at (string) (required) — Unix timestamp when a fixed license was last changed. '0' for temporary licenses. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Unix timestamp when a fixed license was last changed. '0' for temporary licenses. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Person ID that last changed a fixed license. '0' for temporary licenses. - total (integer) (required) — Number of people holding an active license. `, diff --git a/internal/cli/zz_generated_mcp_servers.go b/internal/cli/zz_generated_mcp_servers.go index a2cd478..937cdd7 100644 --- a/internal/cli/zz_generated_mcp_servers.go +++ b/internal/cli/zz_generated_mcp_servers.go @@ -34,7 +34,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - can_edit (boolean) (required) — Whether the caller may edit this server. - command (string) — Executable command (stdio transport only). - connect_timeout (integer) (required) — Connection timeout in seconds (0 = server default, 10s). - - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID that created the server. - description (string) (required) — Server description. - env (object) — Environment variables (stdio transport). Secret values are masked. @@ -56,7 +56,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - input_schema (object) — JSON Schema describing the tool's input parameters. - name (string) (required) — Tool name. - transport (string) (required) — Transport protocol. One of: 'stdio' (standard I/O to a local subprocess), 'sse' (standalone SSE, the legacy MCP transport), 'streamable-http' (the newer HTTP streaming transport). [stdio, sse, streamable-http] - - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - url (string) — Server URL (sse / streamable-http transport). `, Args: requireBodyFieldOrExactArg("server_id", "server-id"), @@ -131,7 +131,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - can_edit (boolean) (required) — Whether the caller may edit this server. - command (string) — Executable command (stdio transport only). - connect_timeout (integer) (required) — Connection timeout in seconds (0 = server default, 10s). - - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID that created the server. - description (string) (required) — Server description. - env (object) — Environment variables (stdio transport). Secret values are masked. @@ -153,7 +153,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - input_schema (object) — JSON Schema describing the tool's input parameters. - name (string) (required) — Tool name. - transport (string) (required) — Transport protocol. One of: 'stdio' (standard I/O to a local subprocess), 'sse' (standalone SSE, the legacy MCP transport), 'streamable-http' (the newer HTTP streaming transport). [stdio, sse, streamable-http] - - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - url (string) — Server URL (sse / streamable-http transport). - total (integer) (required) — Total number of matching servers. `, @@ -272,7 +272,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - can_edit (boolean) (required) — Whether the caller may edit this server. - command (string) — Executable command (stdio transport only). - connect_timeout (integer) (required) — Connection timeout in seconds (0 = server default, 10s). - - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID that created the server. - description (string) (required) — Server description. - env (object) — Environment variables (stdio transport). Secret values are masked. @@ -294,7 +294,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - input_schema (object) — JSON Schema describing the tool's input parameters. - name (string) (required) — Tool name. - transport (string) (required) — Transport protocol. One of: 'stdio' (standard I/O to a local subprocess), 'sse' (standalone SSE, the legacy MCP transport), 'streamable-http' (the newer HTTP streaming transport). [stdio, sse, streamable-http] - - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - url (string) — Server URL (sse / streamable-http transport). `, Example: ` flashduty safari mcp-server-create --data '{"description":"Query Prometheus metrics and alerts.","server_name":"prometheus","status":"enabled","transport":"streamable-http","url":"https://mcp.example.com/prometheus"}'`, @@ -598,7 +598,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - can_edit (boolean) (required) — Whether the caller may edit this server. - command (string) — Executable command (stdio transport only). - connect_timeout (integer) (required) — Connection timeout in seconds (0 = server default, 10s). - - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - created_by (integer) (required) — Member ID that created the server. - description (string) (required) — Server description. - env (object) — Environment variables (stdio transport). Secret values are masked. @@ -620,7 +620,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - input_schema (object) — JSON Schema describing the tool's input parameters. - name (string) (required) — Tool name. - transport (string) (required) — Transport protocol. One of: 'stdio' (standard I/O to a local subprocess), 'sse' (standalone SSE, the legacy MCP transport), 'streamable-http' (the newer HTTP streaming transport). [stdio, sse, streamable-http] - - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - url (string) — Server URL (sse / streamable-http transport). `, Args: requireBodyFieldOrExactArg("server_id", "server-id"), diff --git a/internal/cli/zz_generated_members.go b/internal/cli/zz_generated_members.go index 61e6d39..1fcc106 100644 --- a/internal/cli/zz_generated_members.go +++ b/internal/cli/zz_generated_members.go @@ -296,7 +296,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - account_role_ids (array) (required) — Role IDs - avatar (string) (required) — Avatar URL - country_code (string) (required) — ISO 3166-1 alpha-2 region code of the member's contact phone (e.g. "CN", "US", "HK"). - - created_at (string) (required) — Creation timestamp (Unix seconds) CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Creation timestamp (Unix seconds) CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - email (string) (required) — Email address - email_verified (boolean) (required) — Email verified - is_external (boolean) (required) — Provisioned via SSO @@ -308,7 +308,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - ref_id (string) (required) — External reference ID - status (string) (required) — Member status. 'enabled' — active member; 'pending' — invited but not yet accepted; 'deleted' — removed from the organization. [enabled, pending, deleted] - time_zone (string) — Time zone - - updated_at (string) (required) — Update timestamp (Unix seconds) CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Update timestamp (Unix seconds) CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - limit (integer) — Page size - p (integer) — Current page - total (integer) — Total count diff --git a/internal/cli/zz_generated_notification_templates.go b/internal/cli/zz_generated_notification_templates.go index 3fa930e..363e4ab 100644 --- a/internal/cli/zz_generated_notification_templates.go +++ b/internal/cli/zz_generated_notification_templates.go @@ -25,9 +25,9 @@ Request fields: Response fields ('data' envelope is unwrapped — these fields are at the top level): - account_id (integer) (required) — ID of the owning account. - - created_at (string) (required) — Unix epoch seconds the template was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Unix epoch seconds the template was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — Member ID of the creator. - - deleted_at (string) — Unix epoch seconds the template was soft-deleted. Absent (omitempty) when the template is live. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Unix epoch seconds the template was soft-deleted. Absent (omitempty) when the template is live. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Free-form description. - dingtalk (string) (required) — DingTalk robot message template source. - dingtalk_app (string) (required) — DingTalk app message template source. @@ -45,7 +45,7 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - telegram (string) (required) — Telegram bot message template source. - template_id (string) (required) — Template ID. - template_name (string) (required) — Unique template name within the account. - - updated_at (string) (required) — Unix epoch seconds the template was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Unix epoch seconds the template was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Member ID of the last editor. - voice (string) (required) — Voice call script template source. - wecom (string) (required) — WeCom robot message template source. @@ -120,9 +120,9 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - has_next_page (boolean) (required) — True if another page exists after the returned one. - items (array) (required) — Notification templates on the current page; the first item of the first page is always the built-in preset template. - account_id (integer) (required) — ID of the owning account. - - created_at (string) (required) — Unix epoch seconds the template was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Unix epoch seconds the template was created. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - creator_id (integer) (required) — Member ID of the creator. - - deleted_at (string) — Unix epoch seconds the template was soft-deleted. Absent (omitempty) when the template is live. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - deleted_at (string) — Unix epoch seconds the template was soft-deleted. Absent (omitempty) when the template is live. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - description (string) (required) — Free-form description. - dingtalk (string) (required) — DingTalk robot message template source. - dingtalk_app (string) (required) — DingTalk app message template source. @@ -140,7 +140,7 @@ Response fields ('data' envelope is unwrapped — rows are nested under items[]; - telegram (string) (required) — Telegram bot message template source. - template_id (string) (required) — Template ID. - template_name (string) (required) — Unique template name within the account. - - updated_at (string) (required) — Unix epoch seconds the template was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Unix epoch seconds the template was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - updated_by (integer) (required) — Member ID of the last editor. - voice (string) (required) — Voice call script template source. - wecom (string) (required) — WeCom robot message template source. diff --git a/internal/cli/zz_generated_resources.go b/internal/cli/zz_generated_resources.go index d3eba5d..a549f24 100644 --- a/internal/cli/zz_generated_resources.go +++ b/internal/cli/zz_generated_resources.go @@ -26,9 +26,9 @@ Request fields: Response fields ('data' envelope is unwrapped — these fields are at the top level): - account_id (integer) (required) — Account ID that owns this resource. - action.days (integer) (required) — Retention period in days for action (user interaction) data. - - created_at (string) (required) — Unix timestamp in seconds when the resource was created. Also anchors the start of the first billing window. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - created_at (string) (required) — Unix timestamp in seconds when the resource was created. Also anchors the start of the first billing window. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - error.days (integer) (required) — Retention period in days for error data. - - expired_at (string) — Unix timestamp in seconds when the on-premises license expires. Only present on on-premises deployments; omitted entirely for SaaS accounts. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - expired_at (string) — Unix timestamp in seconds when the on-premises license expires. Only present on on-premises deployments; omitted entirely for SaaS accounts. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - long_task.days (integer) (required) — Retention period in days for long-task data. - offering_id (integer) (required) — ID of the offering (SKU) this resource was provisioned from. - order_id (string) (required) — ID of the order that provisioned this resource. Empty for resources provisioned outside the order flow (e.g. on-premises). @@ -45,11 +45,11 @@ Response fields ('data' envelope is unwrapped — these fields are at the top le - session_replay.free_cnt (integer) (required) — Free quota for session-replay sessions per application, per billing window. - session_replay.used_cnt (integer) (required) — Number of session-replay sessions used in the current billing window. - status (string) (required) — Status of the resource. A resource with status 'deleted' or 'destroyed' never reaches this field — the operation returns 'ResourceNotFound' for those instead. [enabled, disabled] - - updated_at (string) (required) — Unix timestamp in seconds when the resource was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - updated_at (string) (required) — Unix timestamp in seconds when the resource was last updated. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. - version (string) (required) — Plan version of this resource. One of 'free' (free plan) or 'professional' (professional plan). [free, professional] - view.days (integer) (required) — Retention period in days for view (page/screen) data. - - window_end_time (string) (required) — Unix timestamp in seconds for the end of the current 30-day billing window. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. - - window_start_time (string) (required) — Unix timestamp in seconds for the start of the current 30-day billing window. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0. + - window_end_time (string) (required) — Unix timestamp in seconds for the end of the current 30-day billing window. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. + - window_start_time (string) (required) — Unix timestamp in seconds for the start of the current 30-day billing window. CLI '--json' renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null. `, Example: ` flashduty rum resource-info --data '{"no_cache":false}'`, RunE: func(cmd *cobra.Command, args []string) error { diff --git a/internal/cli/zz_generated_response_help.go b/internal/cli/zz_generated_response_help.go index ca96431..67ed899 100644 --- a/internal/cli/zz_generated_response_help.go +++ b/internal/cli/zz_generated_response_help.go @@ -6,210 +6,210 @@ package cli // Response-fields help block. Curated commands look this up via responseHelp() // so they document the same output shape as the generated commands. var responseHelpBySDKMethod = map[string]string{ - "A2aAgents.ReadGet": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - account_id (integer) (required) — Owning account ID.\n - agent_card_name (string) — Agent name resolved from the remote card.\n - agent_card_skills (array) — Skills advertised by the remote card.\n - agent_id (string) (required) — Unique A2A agent ID (prefix `a2a_`).\n - agent_name (string) (required) — Agent display name.\n - allow_insecure_oauth_http (boolean) — Allow non-loopback HTTP OAuth discovery/metadata endpoints for this agent instead of requiring HTTPS.\n - allow_insecure_tls_skip_verify (boolean) — Skip TLS certificate verification when connecting to this agent's endpoint.\n - auth_config (object) — Authentication config; sensitive values (`api_key`, `token`, `client_secret`) are masked.\n - auth_mode (string) — Authentication mode. One of: `shared` (a single static credential saved on the resource and shared by all callers in the account; the default — an empty value behaves the same), `per_user_secret` (each user stores their own secret per `secret_schema`, injected per user at runtime), `per_user_oauth` (each user completes their own OAuth grant; discovery and registration run lazily on first use). [shared, per_user_secret, per_user_oauth]\n - auth_type (string) (required) — Authentication type for reaching the remote agent: `none`, `api_key`, or `bearer`.\n - can_edit (boolean) (required) — Whether the caller may edit this agent.\n - card_resolve_timeout (integer) (required) — Card-resolution timeout in seconds. Always 0 today — the API does not yet expose a way to set it.\n - card_url (string) (required) — URL of the remote agent card.\n - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - created_by (integer) (required) — Member ID that created the agent.\n - environment_id (string) (required) — BYOC runner ID. Set only when `environment_kind=byoc`; empty otherwise.\n - environment_kind (string) (required) — Execution environment binding. Empty selects automatic routing; `byoc` pins the agent to a specific runner named by `environment_id`. [byoc]\n - instructions (string) (required) — Natural-language instructions for the remote agent (formerly named `description`). (≤2000 chars)\n - oauth_metadata (string) — JSON-encoded OAuth metadata (per_user_oauth mode).\n - secret_schema (string) — JSON-encoded secret schema (per_user_secret mode).\n - status (string) (required) — Agent status. [enabled, disabled]\n - streaming (boolean) (required) — Whether the remote agent supports streaming responses.\n - task_timeout (integer) (required) — Single-task execution timeout in seconds. Always 0 today — the API does not yet expose a way to set it.\n - team_id (integer) (required) — Team scope: 0 = account-wide; >0 = the owning team.\n - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n", - "A2aAgents.ReadList": "Response fields (this command's `--json` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - account_id (integer) (required) — Owning account ID.\n - agent_card_name (string) — Agent name resolved from the remote card.\n - agent_card_skills (array) — Skills advertised by the remote card.\n - agent_id (string) (required) — Unique A2A agent ID (prefix `a2a_`).\n - agent_name (string) (required) — Agent display name.\n - allow_insecure_oauth_http (boolean) — Allow non-loopback HTTP OAuth discovery/metadata endpoints for this agent instead of requiring HTTPS.\n - allow_insecure_tls_skip_verify (boolean) — Skip TLS certificate verification when connecting to this agent's endpoint.\n - auth_config (object) — Authentication config; sensitive values (`api_key`, `token`, `client_secret`) are masked.\n - auth_mode (string) — Authentication mode. One of: `shared` (a single static credential saved on the resource and shared by all callers in the account; the default — an empty value behaves the same), `per_user_secret` (each user stores their own secret per `secret_schema`, injected per user at runtime), `per_user_oauth` (each user completes their own OAuth grant; discovery and registration run lazily on first use). [shared, per_user_secret, per_user_oauth]\n - auth_type (string) (required) — Authentication type for reaching the remote agent: `none`, `api_key`, or `bearer`.\n - can_edit (boolean) (required) — Whether the caller may edit this agent.\n - card_resolve_timeout (integer) (required) — Card-resolution timeout in seconds. Always 0 today — the API does not yet expose a way to set it.\n - card_url (string) (required) — URL of the remote agent card.\n - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - created_by (integer) (required) — Member ID that created the agent.\n - environment_id (string) (required) — BYOC runner ID. Set only when `environment_kind=byoc`; empty otherwise.\n - environment_kind (string) (required) — Execution environment binding. Empty selects automatic routing; `byoc` pins the agent to a specific runner named by `environment_id`. [byoc]\n - instructions (string) (required) — Natural-language instructions for the remote agent (formerly named `description`). (≤2000 chars)\n - oauth_metadata (string) — JSON-encoded OAuth metadata (per_user_oauth mode).\n - secret_schema (string) — JSON-encoded secret schema (per_user_secret mode).\n - status (string) (required) — Agent status. [enabled, disabled]\n - streaming (boolean) (required) — Whether the remote agent supports streaming responses.\n - task_timeout (integer) (required) — Single-task execution timeout in seconds. Always 0 today — the API does not yet expose a way to set it.\n - team_id (integer) (required) — Team scope: 0 = account-wide; >0 = the owning team.\n - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n", + "A2aAgents.ReadGet": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - account_id (integer) (required) — Owning account ID.\n - agent_card_name (string) — Agent name resolved from the remote card.\n - agent_card_skills (array) — Skills advertised by the remote card.\n - agent_id (string) (required) — Unique A2A agent ID (prefix `a2a_`).\n - agent_name (string) (required) — Agent display name.\n - allow_insecure_oauth_http (boolean) — Allow non-loopback HTTP OAuth discovery/metadata endpoints for this agent instead of requiring HTTPS.\n - allow_insecure_tls_skip_verify (boolean) — Skip TLS certificate verification when connecting to this agent's endpoint.\n - auth_config (object) — Authentication config; sensitive values (`api_key`, `token`, `client_secret`) are masked.\n - auth_mode (string) — Authentication mode. One of: `shared` (a single static credential saved on the resource and shared by all callers in the account; the default — an empty value behaves the same), `per_user_secret` (each user stores their own secret per `secret_schema`, injected per user at runtime), `per_user_oauth` (each user completes their own OAuth grant; discovery and registration run lazily on first use). [shared, per_user_secret, per_user_oauth]\n - auth_type (string) (required) — Authentication type for reaching the remote agent: `none`, `api_key`, or `bearer`.\n - can_edit (boolean) (required) — Whether the caller may edit this agent.\n - card_resolve_timeout (integer) (required) — Card-resolution timeout in seconds. Always 0 today — the API does not yet expose a way to set it.\n - card_url (string) (required) — URL of the remote agent card.\n - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - created_by (integer) (required) — Member ID that created the agent.\n - environment_id (string) (required) — BYOC runner ID. Set only when `environment_kind=byoc`; empty otherwise.\n - environment_kind (string) (required) — Execution environment binding. Empty selects automatic routing; `byoc` pins the agent to a specific runner named by `environment_id`. [byoc]\n - instructions (string) (required) — Natural-language instructions for the remote agent (formerly named `description`). (≤2000 chars)\n - oauth_metadata (string) — JSON-encoded OAuth metadata (per_user_oauth mode).\n - secret_schema (string) — JSON-encoded secret schema (per_user_secret mode).\n - status (string) (required) — Agent status. [enabled, disabled]\n - streaming (boolean) (required) — Whether the remote agent supports streaming responses.\n - task_timeout (integer) (required) — Single-task execution timeout in seconds. Always 0 today — the API does not yet expose a way to set it.\n - team_id (integer) (required) — Team scope: 0 = account-wide; >0 = the owning team.\n - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n", + "A2aAgents.ReadList": "Response fields (this command's `--json` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - account_id (integer) (required) — Owning account ID.\n - agent_card_name (string) — Agent name resolved from the remote card.\n - agent_card_skills (array) — Skills advertised by the remote card.\n - agent_id (string) (required) — Unique A2A agent ID (prefix `a2a_`).\n - agent_name (string) (required) — Agent display name.\n - allow_insecure_oauth_http (boolean) — Allow non-loopback HTTP OAuth discovery/metadata endpoints for this agent instead of requiring HTTPS.\n - allow_insecure_tls_skip_verify (boolean) — Skip TLS certificate verification when connecting to this agent's endpoint.\n - auth_config (object) — Authentication config; sensitive values (`api_key`, `token`, `client_secret`) are masked.\n - auth_mode (string) — Authentication mode. One of: `shared` (a single static credential saved on the resource and shared by all callers in the account; the default — an empty value behaves the same), `per_user_secret` (each user stores their own secret per `secret_schema`, injected per user at runtime), `per_user_oauth` (each user completes their own OAuth grant; discovery and registration run lazily on first use). [shared, per_user_secret, per_user_oauth]\n - auth_type (string) (required) — Authentication type for reaching the remote agent: `none`, `api_key`, or `bearer`.\n - can_edit (boolean) (required) — Whether the caller may edit this agent.\n - card_resolve_timeout (integer) (required) — Card-resolution timeout in seconds. Always 0 today — the API does not yet expose a way to set it.\n - card_url (string) (required) — URL of the remote agent card.\n - created_at (string) (required) — Creation time. Unix timestamp in milliseconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - created_by (integer) (required) — Member ID that created the agent.\n - environment_id (string) (required) — BYOC runner ID. Set only when `environment_kind=byoc`; empty otherwise.\n - environment_kind (string) (required) — Execution environment binding. Empty selects automatic routing; `byoc` pins the agent to a specific runner named by `environment_id`. [byoc]\n - instructions (string) (required) — Natural-language instructions for the remote agent (formerly named `description`). (≤2000 chars)\n - oauth_metadata (string) — JSON-encoded OAuth metadata (per_user_oauth mode).\n - secret_schema (string) — JSON-encoded secret schema (per_user_secret mode).\n - status (string) (required) — Agent status. [enabled, disabled]\n - streaming (boolean) (required) — Whether the remote agent supports streaming responses.\n - task_timeout (integer) (required) — Single-task execution timeout in seconds. Always 0 today — the API does not yet expose a way to set it.\n - team_id (integer) (required) — Team scope: 0 = account-wide; >0 = the owning team.\n - updated_at (string) (required) — Last update time. Unix timestamp in milliseconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n", "A2aAgents.WriteCreate": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - agent_id (string) (required) — ID of the newly created agent.\n", - "Account.Info": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - account_id (integer) — Account identifier.\n - account_name (string) — Account name.\n - avatar (string) — Account avatar URL.\n - country_code (string) — ISO 3166-1 alpha-2 region code of the contact phone (e.g. \"CN\", \"US\", \"HK\").\n - created_at (string) — Account creation time, Unix timestamp in seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - domain (string) — Primary account domain (login subdomain).\n - email (string) — Account contact email.\n - extra_domains (array) — Additional account domains.\n - locale (string) — Account language preference (e.g. zh-CN, en-US).\n - mp_account_id (string) — Account identifier on the cloud marketplace platform (present only for marketplace accounts).\n - mp_plat (string) — Cloud marketplace platform the account was provisioned from (present only for marketplace accounts).\n - phone (string) — Account contact phone, masked for privacy.\n - restrictions (object) — Account access restrictions (present only when configured).\n - allow_subdomain (boolean) — Whether subdomains of the allowed email domains are also accepted.\n - email_domains (array) — Allowed login email domains.\n - ips (array) — Allowed source IP/CIDR whitelist.\n - time_zone (string) — Account default timezone (IANA name, e.g. Asia/Shanghai).\n", - "AlertEnrichment.EnrichmentReadInfo": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - created_at (string) (required) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - creator_id (integer) (required) — Creator member ID.\n - integration_id (integer) (required) — Integration ID.\n - rules (array) (required) — Ordered enrichment rules.\n - if (array) — Optional AND-filter list. The rule is skipped if the condition does not match.\n - key (string) (required) — Alert label key.\n - oper (string) (required) — Match operator. `IN` matches when any value matches; `NOTIN` matches when none of the values match. [IN, NOTIN]\n - vals (array) (required) — Values to match against.\n - kind (string) (required) — Rule type. `extraction` extracts a label via regex or GJson. `composition` builds a label from a template. `mapping` looks up values from a schema or API. `drop` removes labels. [extraction, composition, mapping, drop]\n - settings (object) (required) — Rule-kind–specific settings. The shape depends on `kind`.\n - api_id (string) — Mapping API ID (MongoDB ObjectID hex). Required when `mapping_type` is `api`.\n - drop_labels (array) — List of label keys to remove from the alert.\n - g_json (string) — GJson path expression used to extract a value from a JSON-encoded field. Mutually exclusive with `pattern`.\n - mapping_type (string) — Mapping source type. `schema` uses a mapping schema table; `api` calls an external HTTP API. [schema, api]\n - override (boolean) — When `true`, overwrite the label if it already exists. Defaults to `false`.\n - pattern (string) — RE2 regular expression. Use a named capture group `(?P...)` to extract a sub-match; without a named group the full match is used. Mutually exclusive with `g_json`.\n - result_label (string) — Destination label key to write the extracted value into. Must match `^[a-z][a-z0-9_]{0,62}$`.\n - result_labels (array) — Label keys to populate from the mapping lookup result.\n - schema_id (string) — Mapping schema ID (MongoDB ObjectID hex). Required when `mapping_type` is `schema`.\n - source_field (string) — Source field to extract from. Must be `title`, `description`, or a label key prefixed with `labels.` (e.g. `labels.env`).\n - template (string) — Go `text/template` string. Alert fields are available as `{{.title}}`, `{{.description}}`, and `{{.labels.key}}`. Example: `{{.labels.region}}-{{.labels.env}}`. (≤500 chars)\n - status (string) (required) — Rule set status.\n - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - updated_by (integer) (required) — Last updater member ID.\n", - "AlertEnrichment.EnrichmentReadList": "Response fields (this command's `--json` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - created_at (string) (required) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - creator_id (integer) (required) — Creator member ID.\n - integration_id (integer) (required) — Integration ID.\n - rules (array) (required) — Ordered enrichment rules.\n - if (array) — Optional AND-filter list. The rule is skipped if the condition does not match.\n - key (string) (required) — Alert label key.\n - oper (string) (required) — Match operator. `IN` matches when any value matches; `NOTIN` matches when none of the values match. [IN, NOTIN]\n - vals (array) (required) — Values to match against.\n - kind (string) (required) — Rule type. `extraction` extracts a label via regex or GJson. `composition` builds a label from a template. `mapping` looks up values from a schema or API. `drop` removes labels. [extraction, composition, mapping, drop]\n - settings (object) (required) — Rule-kind–specific settings. The shape depends on `kind`.\n - api_id (string) — Mapping API ID (MongoDB ObjectID hex). Required when `mapping_type` is `api`.\n - drop_labels (array) — List of label keys to remove from the alert.\n - g_json (string) — GJson path expression used to extract a value from a JSON-encoded field. Mutually exclusive with `pattern`.\n - mapping_type (string) — Mapping source type. `schema` uses a mapping schema table; `api` calls an external HTTP API. [schema, api]\n - override (boolean) — When `true`, overwrite the label if it already exists. Defaults to `false`.\n - pattern (string) — RE2 regular expression. Use a named capture group `(?P...)` to extract a sub-match; without a named group the full match is used. Mutually exclusive with `g_json`.\n - result_label (string) — Destination label key to write the extracted value into. Must match `^[a-z][a-z0-9_]{0,62}$`.\n - result_labels (array) — Label keys to populate from the mapping lookup result.\n - schema_id (string) — Mapping schema ID (MongoDB ObjectID hex). Required when `mapping_type` is `schema`.\n - source_field (string) — Source field to extract from. Must be `title`, `description`, or a label key prefixed with `labels.` (e.g. `labels.env`).\n - template (string) — Go `text/template` string. Alert fields are available as `{{.title}}`, `{{.description}}`, and `{{.labels.key}}`. Example: `{{.labels.region}}-{{.labels.env}}`. (≤500 chars)\n - status (string) (required) — Rule set status.\n - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - updated_by (integer) (required) — Last updater member ID.\n", - "AlertEnrichment.FieldReadInfo": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - account_id (integer) (required) — Owning account ID.\n - created_at (string) (required) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - creator_id (integer) (required) — Creator member ID.\n - default_value (any) — Default value. Type depends on `field_type`: `bool` for checkbox; `string` for single_select/text; `string[]` for multi_select; may be `null` if no default.\n - deleted_at (string) — Deletion timestamp, Unix seconds. Only present for soft-deleted fields. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - description (string) — Optional free-text description. (≤499 chars)\n - display_name (string) (required) — Human-readable name shown in the UI. (≤39 chars)\n - field_id (string) (required) — Field ID — 24-character hex ObjectID.\n - field_name (string) (required) — Machine name used in incident payloads under `fields.`. Immutable. (≤39 chars)\n - field_type (string) (required) — Field type. | Value | Meaning | |---|---| | `checkbox` | Checkbox; value is a bool, options are not supported. | | `multi_select` | Multi-select; value is a string array, each element must be one of options. | | `single_select` | Single-select; value is a string from options. | | `text` | Free text; value is a string. | [checkbox, multi_select, single_select, text]\n - options (any) — Allowed choices for `single_select`/`multi_select` (non-empty unique string array). `null` or empty for `checkbox`/`text`.\n - status (string) (required) — Field status (e.g. `enabled`, `deleted`).\n - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - updated_by (integer) (required) — Last updater member ID.\n - value_type (string) (required) — Value type. `checkbox` is always `bool`; `single_select`/`multi_select`/`text` are always `string`. `float` is reserved and never occurs today. [string, bool, float]\n", - "AlertEnrichment.FieldReadList": "Response fields (this command's `--json` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - account_id (integer) (required) — Owning account ID.\n - created_at (string) (required) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - creator_id (integer) (required) — Creator member ID.\n - default_value (any) — Default value. Type depends on `field_type`: `bool` for checkbox; `string` for single_select/text; `string[]` for multi_select; may be `null` if no default.\n - deleted_at (string) — Deletion timestamp, Unix seconds. Only present for soft-deleted fields. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - description (string) — Optional free-text description. (≤499 chars)\n - display_name (string) (required) — Human-readable name shown in the UI. (≤39 chars)\n - field_id (string) (required) — Field ID — 24-character hex ObjectID.\n - field_name (string) (required) — Machine name used in incident payloads under `fields.`. Immutable. (≤39 chars)\n - field_type (string) (required) — Field type. | Value | Meaning | |---|---| | `checkbox` | Checkbox; value is a bool, options are not supported. | | `multi_select` | Multi-select; value is a string array, each element must be one of options. | | `single_select` | Single-select; value is a string from options. | | `text` | Free text; value is a string. | [checkbox, multi_select, single_select, text]\n - options (any) — Allowed choices for `single_select`/`multi_select` (non-empty unique string array). `null` or empty for `checkbox`/`text`.\n - status (string) (required) — Field status (e.g. `enabled`, `deleted`).\n - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - updated_by (integer) (required) — Last updater member ID.\n - value_type (string) (required) — Value type. `checkbox` is always `bool`; `single_select`/`multi_select`/`text` are always `string`. `float` is reserved and never occurs today. [string, bool, float]\n", + "Account.Info": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - account_id (integer) — Account identifier.\n - account_name (string) — Account name.\n - avatar (string) — Account avatar URL.\n - country_code (string) — ISO 3166-1 alpha-2 region code of the contact phone (e.g. \"CN\", \"US\", \"HK\").\n - created_at (string) — Account creation time, Unix timestamp in seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - domain (string) — Primary account domain (login subdomain).\n - email (string) — Account contact email.\n - extra_domains (array) — Additional account domains.\n - locale (string) — Account language preference (e.g. zh-CN, en-US).\n - mp_account_id (string) — Account identifier on the cloud marketplace platform (present only for marketplace accounts).\n - mp_plat (string) — Cloud marketplace platform the account was provisioned from (present only for marketplace accounts).\n - phone (string) — Account contact phone, masked for privacy.\n - restrictions (object) — Account access restrictions (present only when configured).\n - allow_subdomain (boolean) — Whether subdomains of the allowed email domains are also accepted.\n - email_domains (array) — Allowed login email domains.\n - ips (array) — Allowed source IP/CIDR whitelist.\n - time_zone (string) — Account default timezone (IANA name, e.g. Asia/Shanghai).\n", + "AlertEnrichment.EnrichmentReadInfo": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - created_at (string) (required) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - creator_id (integer) (required) — Creator member ID.\n - integration_id (integer) (required) — Integration ID.\n - rules (array) (required) — Ordered enrichment rules.\n - if (array) — Optional AND-filter list. The rule is skipped if the condition does not match.\n - key (string) (required) — Alert label key.\n - oper (string) (required) — Match operator. `IN` matches when any value matches; `NOTIN` matches when none of the values match. [IN, NOTIN]\n - vals (array) (required) — Values to match against.\n - kind (string) (required) — Rule type. `extraction` extracts a label via regex or GJson. `composition` builds a label from a template. `mapping` looks up values from a schema or API. `drop` removes labels. [extraction, composition, mapping, drop]\n - settings (object) (required) — Rule-kind–specific settings. The shape depends on `kind`.\n - api_id (string) — Mapping API ID (MongoDB ObjectID hex). Required when `mapping_type` is `api`.\n - drop_labels (array) — List of label keys to remove from the alert.\n - g_json (string) — GJson path expression used to extract a value from a JSON-encoded field. Mutually exclusive with `pattern`.\n - mapping_type (string) — Mapping source type. `schema` uses a mapping schema table; `api` calls an external HTTP API. [schema, api]\n - override (boolean) — When `true`, overwrite the label if it already exists. Defaults to `false`.\n - pattern (string) — RE2 regular expression. Use a named capture group `(?P...)` to extract a sub-match; without a named group the full match is used. Mutually exclusive with `g_json`.\n - result_label (string) — Destination label key to write the extracted value into. Must match `^[a-z][a-z0-9_]{0,62}$`.\n - result_labels (array) — Label keys to populate from the mapping lookup result.\n - schema_id (string) — Mapping schema ID (MongoDB ObjectID hex). Required when `mapping_type` is `schema`.\n - source_field (string) — Source field to extract from. Must be `title`, `description`, or a label key prefixed with `labels.` (e.g. `labels.env`).\n - template (string) — Go `text/template` string. Alert fields are available as `{{.title}}`, `{{.description}}`, and `{{.labels.key}}`. Example: `{{.labels.region}}-{{.labels.env}}`. (≤500 chars)\n - status (string) (required) — Rule set status.\n - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - updated_by (integer) (required) — Last updater member ID.\n", + "AlertEnrichment.EnrichmentReadList": "Response fields (this command's `--json` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - created_at (string) (required) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - creator_id (integer) (required) — Creator member ID.\n - integration_id (integer) (required) — Integration ID.\n - rules (array) (required) — Ordered enrichment rules.\n - if (array) — Optional AND-filter list. The rule is skipped if the condition does not match.\n - key (string) (required) — Alert label key.\n - oper (string) (required) — Match operator. `IN` matches when any value matches; `NOTIN` matches when none of the values match. [IN, NOTIN]\n - vals (array) (required) — Values to match against.\n - kind (string) (required) — Rule type. `extraction` extracts a label via regex or GJson. `composition` builds a label from a template. `mapping` looks up values from a schema or API. `drop` removes labels. [extraction, composition, mapping, drop]\n - settings (object) (required) — Rule-kind–specific settings. The shape depends on `kind`.\n - api_id (string) — Mapping API ID (MongoDB ObjectID hex). Required when `mapping_type` is `api`.\n - drop_labels (array) — List of label keys to remove from the alert.\n - g_json (string) — GJson path expression used to extract a value from a JSON-encoded field. Mutually exclusive with `pattern`.\n - mapping_type (string) — Mapping source type. `schema` uses a mapping schema table; `api` calls an external HTTP API. [schema, api]\n - override (boolean) — When `true`, overwrite the label if it already exists. Defaults to `false`.\n - pattern (string) — RE2 regular expression. Use a named capture group `(?P...)` to extract a sub-match; without a named group the full match is used. Mutually exclusive with `g_json`.\n - result_label (string) — Destination label key to write the extracted value into. Must match `^[a-z][a-z0-9_]{0,62}$`.\n - result_labels (array) — Label keys to populate from the mapping lookup result.\n - schema_id (string) — Mapping schema ID (MongoDB ObjectID hex). Required when `mapping_type` is `schema`.\n - source_field (string) — Source field to extract from. Must be `title`, `description`, or a label key prefixed with `labels.` (e.g. `labels.env`).\n - template (string) — Go `text/template` string. Alert fields are available as `{{.title}}`, `{{.description}}`, and `{{.labels.key}}`. Example: `{{.labels.region}}-{{.labels.env}}`. (≤500 chars)\n - status (string) (required) — Rule set status.\n - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - updated_by (integer) (required) — Last updater member ID.\n", + "AlertEnrichment.FieldReadInfo": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - account_id (integer) (required) — Owning account ID.\n - created_at (string) (required) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - creator_id (integer) (required) — Creator member ID.\n - default_value (any) — Default value. Type depends on `field_type`: `bool` for checkbox; `string` for single_select/text; `string[]` for multi_select; may be `null` if no default.\n - deleted_at (string) — Deletion timestamp, Unix seconds. Only present for soft-deleted fields. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - description (string) — Optional free-text description. (≤499 chars)\n - display_name (string) (required) — Human-readable name shown in the UI. (≤39 chars)\n - field_id (string) (required) — Field ID — 24-character hex ObjectID.\n - field_name (string) (required) — Machine name used in incident payloads under `fields.`. Immutable. (≤39 chars)\n - field_type (string) (required) — Field type. | Value | Meaning | |---|---| | `checkbox` | Checkbox; value is a bool, options are not supported. | | `multi_select` | Multi-select; value is a string array, each element must be one of options. | | `single_select` | Single-select; value is a string from options. | | `text` | Free text; value is a string. | [checkbox, multi_select, single_select, text]\n - options (any) — Allowed choices for `single_select`/`multi_select` (non-empty unique string array). `null` or empty for `checkbox`/`text`.\n - status (string) (required) — Field status (e.g. `enabled`, `deleted`).\n - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - updated_by (integer) (required) — Last updater member ID.\n - value_type (string) (required) — Value type. `checkbox` is always `bool`; `single_select`/`multi_select`/`text` are always `string`. `float` is reserved and never occurs today. [string, bool, float]\n", + "AlertEnrichment.FieldReadList": "Response fields (this command's `--json` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - account_id (integer) (required) — Owning account ID.\n - created_at (string) (required) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - creator_id (integer) (required) — Creator member ID.\n - default_value (any) — Default value. Type depends on `field_type`: `bool` for checkbox; `string` for single_select/text; `string[]` for multi_select; may be `null` if no default.\n - deleted_at (string) — Deletion timestamp, Unix seconds. Only present for soft-deleted fields. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - description (string) — Optional free-text description. (≤499 chars)\n - display_name (string) (required) — Human-readable name shown in the UI. (≤39 chars)\n - field_id (string) (required) — Field ID — 24-character hex ObjectID.\n - field_name (string) (required) — Machine name used in incident payloads under `fields.`. Immutable. (≤39 chars)\n - field_type (string) (required) — Field type. | Value | Meaning | |---|---| | `checkbox` | Checkbox; value is a bool, options are not supported. | | `multi_select` | Multi-select; value is a string array, each element must be one of options. | | `single_select` | Single-select; value is a string from options. | | `text` | Free text; value is a string. | [checkbox, multi_select, single_select, text]\n - options (any) — Allowed choices for `single_select`/`multi_select` (non-empty unique string array). `null` or empty for `checkbox`/`text`.\n - status (string) (required) — Field status (e.g. `enabled`, `deleted`).\n - updated_at (string) (required) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - updated_by (integer) (required) — Last updater member ID.\n - value_type (string) (required) — Value type. `checkbox` is always `bool`; `single_select`/`multi_select`/`text` are always `string`. `float` is reserved and never occurs today. [string, bool, float]\n", "AlertEnrichment.FieldWriteCreate": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - field_id (string) (required) — Newly assigned field ID — 24-character hex ObjectID.\n - field_name (string) (required) — Echo of the submitted `field_name`.\n", - "AlertEnrichment.MappingAPIReadInfo": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - api_id (string) (required) — API ID (MongoDB ObjectID hex).\n - api_name (string) (required) — API name.\n - created_at (string) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - creator_id (integer) (required) — Creator member ID.\n - description (string) (required) — Description.\n - headers (object) (required) — Custom request headers.\n - insecure_skip_verify (boolean) (required) — Whether TLS verification is skipped.\n - retry_count (integer) (required) — Retry count.\n - status (string) (required) — API status.\n - team_id (integer) (required) — Owning team ID.\n - timeout (integer) (required) — Request timeout in seconds.\n - updated_at (string) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - updated_by (integer) (required) — Last updater member ID.\n - url (string) (required) — Endpoint URL.\n", - "AlertEnrichment.MappingAPIReadList": "Response fields (this command's `--json` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - api_id (string) (required) — API ID (MongoDB ObjectID hex).\n - api_name (string) (required) — API name.\n - created_at (string) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - creator_id (integer) (required) — Creator member ID.\n - description (string) (required) — Description.\n - headers (object) (required) — Custom request headers.\n - insecure_skip_verify (boolean) (required) — Whether TLS verification is skipped.\n - retry_count (integer) (required) — Retry count.\n - status (string) (required) — API status.\n - team_id (integer) (required) — Owning team ID.\n - timeout (integer) (required) — Request timeout in seconds.\n - updated_at (string) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - updated_by (integer) (required) — Last updater member ID.\n - url (string) (required) — Endpoint URL.\n", + "AlertEnrichment.MappingAPIReadInfo": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - api_id (string) (required) — API ID (MongoDB ObjectID hex).\n - api_name (string) (required) — API name.\n - created_at (string) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - creator_id (integer) (required) — Creator member ID.\n - description (string) (required) — Description.\n - headers (object) (required) — Custom request headers.\n - insecure_skip_verify (boolean) (required) — Whether TLS verification is skipped.\n - retry_count (integer) (required) — Retry count.\n - status (string) (required) — API status.\n - team_id (integer) (required) — Owning team ID.\n - timeout (integer) (required) — Request timeout in seconds.\n - updated_at (string) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - updated_by (integer) (required) — Last updater member ID.\n - url (string) (required) — Endpoint URL.\n", + "AlertEnrichment.MappingAPIReadList": "Response fields (this command's `--json` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - api_id (string) (required) — API ID (MongoDB ObjectID hex).\n - api_name (string) (required) — API name.\n - created_at (string) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - creator_id (integer) (required) — Creator member ID.\n - description (string) (required) — Description.\n - headers (object) (required) — Custom request headers.\n - insecure_skip_verify (boolean) (required) — Whether TLS verification is skipped.\n - retry_count (integer) (required) — Retry count.\n - status (string) (required) — API status.\n - team_id (integer) (required) — Owning team ID.\n - timeout (integer) (required) — Request timeout in seconds.\n - updated_at (string) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - updated_by (integer) (required) — Last updater member ID.\n - url (string) (required) — Endpoint URL.\n", "AlertEnrichment.MappingAPIWriteCreate": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - api_id (string) (required) — Created API ID (MongoDB ObjectID hex).\n - api_name (string) (required) — API name.\n", - "AlertEnrichment.MappingDataReadList": "Response fields (this command's `--json` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - created_at (string) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - fields (object) — All label key-value pairs for this row.\n - key (string) — Composite key derived from source label values.\n - updated_at (string) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n", + "AlertEnrichment.MappingDataReadList": "Response fields (this command's `--json` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - created_at (string) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - fields (object) — All label key-value pairs for this row.\n - key (string) — Composite key derived from source label values.\n - updated_at (string) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n", "AlertEnrichment.MappingDataWriteUpsert": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - keys (array) (required) — Composite keys of upserted rows.\n", - "AlertEnrichment.MappingSchemaReadInfo": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - created_at (string) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - creator_id (integer) (required) — Creator member ID.\n - description (string) (required) — Schema description.\n - result_labels (array) (required) — Output label names.\n - schema_id (string) (required) — Schema ID (MongoDB ObjectID hex).\n - schema_name (string) (required) — Schema name.\n - source_labels (array) (required) — Lookup key label names.\n - status (string) (required) — Schema status.\n - team_id (integer) (required) — Owning team ID.\n - updated_at (string) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - updated_by (integer) (required) — Last updater member ID.\n", - "AlertEnrichment.MappingSchemaReadList": "Response fields (this command's `--json` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - created_at (string) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - creator_id (integer) (required) — Creator member ID.\n - description (string) (required) — Schema description.\n - result_labels (array) (required) — Output label names.\n - schema_id (string) (required) — Schema ID (MongoDB ObjectID hex).\n - schema_name (string) (required) — Schema name.\n - source_labels (array) (required) — Lookup key label names.\n - status (string) (required) — Schema status.\n - team_id (integer) (required) — Owning team ID.\n - updated_at (string) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - updated_by (integer) (required) — Last updater member ID.\n", + "AlertEnrichment.MappingSchemaReadInfo": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - created_at (string) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - creator_id (integer) (required) — Creator member ID.\n - description (string) (required) — Schema description.\n - result_labels (array) (required) — Output label names.\n - schema_id (string) (required) — Schema ID (MongoDB ObjectID hex).\n - schema_name (string) (required) — Schema name.\n - source_labels (array) (required) — Lookup key label names.\n - status (string) (required) — Schema status.\n - team_id (integer) (required) — Owning team ID.\n - updated_at (string) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - updated_by (integer) (required) — Last updater member ID.\n", + "AlertEnrichment.MappingSchemaReadList": "Response fields (this command's `--json` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - created_at (string) — Creation timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - creator_id (integer) (required) — Creator member ID.\n - description (string) (required) — Schema description.\n - result_labels (array) (required) — Output label names.\n - schema_id (string) (required) — Schema ID (MongoDB ObjectID hex).\n - schema_name (string) (required) — Schema name.\n - source_labels (array) (required) — Lookup key label names.\n - status (string) (required) — Schema status.\n - team_id (integer) (required) — Owning team ID.\n - updated_at (string) — Last update timestamp, Unix seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - updated_by (integer) (required) — Last updater member ID.\n", "AlertEnrichment.MappingSchemaWriteCreate": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - schema_id (string) (required) — Created schema ID (MongoDB ObjectID hex).\n - schema_name (string) (required) — Schema name.\n", - "AlertRules.ReadAuditDetail": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - account_id (integer) (required) — ID of the account that owns the rule.\n - action (string) (required) — Action performed, e.g. `create`, `update`.\n - alert_rule_id (integer) (required) — ID of the alert rule this record belongs to.\n - content (string) — JSON string of the full rule snapshot at audit time. Populated on `/monit/rule/audit/detail`, omitted on list responses.\n - created_at (string) (required) — When this audit record was produced, as a Unix timestamp in seconds; equals the rule's `updated_at` at change time. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - creator_id (integer) (required) — ID of the user who made this change (taken from the rule's `updater_id` at change time).\n - creator_name (string) (required) — Name of the user who made this change (taken from the rule's `updater_name` at change time).\n - id (integer) (required) — Audit record ID.\n", - "AlertRules.ReadAudits": "Response fields (`data` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - account_id (integer) (required) — ID of the account that owns the rule.\n - action (string) (required) — Action performed, e.g. `create`, `update`.\n - alert_rule_id (integer) (required) — ID of the alert rule this record belongs to.\n - content (string) — JSON string of the full rule snapshot at audit time. Populated on `/monit/rule/audit/detail`, omitted on list responses.\n - created_at (string) (required) — When this audit record was produced, as a Unix timestamp in seconds; equals the rule's `updated_at` at change time. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - creator_id (integer) (required) — ID of the user who made this change (taken from the rule's `updater_id` at change time).\n - creator_name (string) (required) — Name of the user who made this change (taken from the rule's `updater_name` at change time).\n - id (integer) (required) — Audit record ID.\n", + "AlertRules.ReadAuditDetail": "Response fields (`data` envelope is unwrapped — these fields are at the top level):\n - account_id (integer) (required) — ID of the account that owns the rule.\n - action (string) (required) — Action performed, e.g. `create`, `update`.\n - alert_rule_id (integer) (required) — ID of the alert rule this record belongs to.\n - content (string) — JSON string of the full rule snapshot at audit time. Populated on `/monit/rule/audit/detail`, omitted on list responses.\n - created_at (string) (required) — When this audit record was produced, as a Unix timestamp in seconds; equals the rule's `updated_at` at change time. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - creator_id (integer) (required) — ID of the user who made this change (taken from the rule's `updater_id` at change time).\n - creator_name (string) (required) — Name of the user who made this change (taken from the rule's `updater_name` at change time).\n - id (integer) (required) — Audit record ID.\n", + "AlertRules.ReadAudits": "Response fields (`data` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - account_id (integer) (required) — ID of the account that owns the rule.\n - action (string) (required) — Action performed, e.g. `create`, `update`.\n - alert_rule_id (integer) (required) — ID of the alert rule this record belongs to.\n - content (string) — JSON string of the full rule snapshot at audit time. Populated on `/monit/rule/audit/detail`, omitted on list responses.\n - created_at (string) (required) — When this audit record was produced, as a Unix timestamp in seconds; equals the rule's `updated_at` at change time. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - creator_id (integer) (required) — ID of the user who made this change (taken from the rule's `updater_id` at change time).\n - creator_name (string) (required) — Name of the user who made this change (taken from the rule's `updater_name` at change time).\n - id (integer) (required) — Audit record ID.\n", "AlertRules.ReadCounterStatus": "Response fields (`data` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - folder_id (integer) (required) — ID of the folder (grouping node).\n - folder_name (string) — Folder name; omitted by some endpoints (`omitempty`).\n - rule_total (integer) (required) — Total rules in the folder family.\n - triggered_rule_count (integer) (required) — Rules with active alerts.\n", - "AlertRules.ReadCounterTotal": "Response fields (`data` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - account_id (integer) (required) — ID of the account this snapshot belongs to.\n - clock (string) (required) — Sample timestamp, Unix epoch seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value stays the bare integer 0.\n - id (integer) (required) — ID of this snapshot record.\n - num (integer) (required) — Rule count at the sample time.\n", + "AlertRules.ReadCounterTotal": "Response fields (`data` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - account_id (integer) (required) — ID of the account this snapshot belongs to.\n - clock (string) (required) — Sample timestamp, Unix epoch seconds. CLI `--json` renders this as an RFC3339 string in the process's local timezone (NOT UTC, and NOT the wire integer); an unset value renders as null.\n - id (integer) (required) — ID of this snapshot record.\n - num (integer) (required) — Rule count at the sample time.\n", "AlertRules.ReadDstypes": "Response fields (`data` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - account_id (integer) (required) — Owning account ID. `0` for global types.\n - id (integer) (required) — ID of the datasource type record.\n - ident (string) (required) — Identifier used as the `ds_type` of rules, e.g. `prometheus`.\n - name (string) (required) — Display name, e.g. `Prometheus`.\n - weight (integer) (required) — Display order weight; higher appears first.\n", "AlertRules.ReadExport": "Response fields (`data` is a TOP-LEVEL array of these row objects — pipe `jq '.[]'`, NOT `.items[]`):\n - annotations (object) — Custom annotation key-value pairs attached to alert events; keys must not start with `$` (reserved for query field references).\n - cron_pattern (string) (required) — Evaluation schedule as a 6-field cron expression (seconds included) or `@every ` (an integral number of seconds, at least 1s); `CRON_TZ=`/`TZ=` prefixes are rejected — set the timezone in `timezone` instead.\n - debug_log_enabled (boolean) (required) — Whether to emit debug logs for this rule's evaluations; enable when troubleshooting.\n - delay_seconds (integer) — Query time offset in seconds: each evaluation reads data as of `schedule time − delay_seconds` to tolerate ingestion lag; `0` means no offset.\n - description (string) — Rule description in the format given by `description_type`, shown with alert events.\n - description_type (string) — Format of `description`, `text` or `markdown`; treated as `text` when omitted. [text, markdown]\n - ds_ids (array) — Datasource ID list, merged with `ds_list`; references by ID and is therefore immune to datasource renames.\n - ds_list (array) — Datasource name list with wildcard support; merged with `ds_ids` to decide which datasources the rule monitors — must be maintained by hand if a datasource is renamed.\n - ds_type (string) (required) — Datasource type ident, e.g. `prometheus`; must be a datasource type (`ident`) that exists in the import target environment.\n - enabled (boolean) (required) — Whether the rule is enabled; rules imported as disabled are not evaluated.\n - enabled_times (array) — Effective time windows; each entry has `days` (0–6, 0 = Sunday) and `stime`/`etime` (`HH:MM`), interpreted in the rule's `timezone`; an empty list disables the rule.\n - days (array) — Days of week, 0 = Sunday.\n - etime (string) — End time, e.g. `18:00`.\n - stime (string) — Start time, e.g. `09:00`.\n - labels (object) — Custom label key-value pairs attached to alert events produced by this rule.\n - name (string) (required) — Rule name, up to 128 characters when imported.\n - repeat_interval (integer) — Interval in seconds between repeated notifications for a firing alert; values below 1 fall back to the default of 3600.\n - repeat_total (integer) — Maximum number of repeated notifications for the same alert; values below 1 fall back to the default of 3.\n - rule_configs (object) — Rule evaluation configuration.\n - check_anydata (object) — Any-data check configuration. Fires when the query returns any data rows.\n - alerting_check_times (integer) — Number of consecutive evaluations that must satisfy the condition before alerting; minimum 1.\n - enabled (boolean) — Whether any-data checking is enabled: any returned data row triggers an alert.\n - push_recovery_event (boolean) — Whether to push a recovery event notification when the alert resolves.\n - recovery (object) — Recovery condition for any-data check. If omitted or `mode` is empty, treated as `nodata`.\n - args (object) — Datasource-specific options for the recovery query, same convention as `queries[].args`; required for Elasticsearch datasources when `mode` is `ql`.\n - condition (string) — Recovery expression. Required when `mode` is `ql`.\n - mode (string) — `nodata` = recover when the query returns no data; `ql` = recover when the `condition` expression evaluates to true. When `mode` is `ql`, only a single query (`name=A`) is permitted. [nodata, ql]\n - recovery_check_times (integer) — Number of consecutive evaluations that must satisfy the recovery condition before resolving; minimum 1.\n - severity (string) — Severity of any-data alert events; case-sensitive. [Critical, Warning, Info]\n - check_nodata (object) — No-data check configuration.\n - alert_on_empty_result (boolean) — Whether to trigger an alert when every query returns an empty result.\n - alert_on_empty_result_severity (string) — Severity of empty-result alerts, case-sensitive; only effective when `alert_on_empty_result` is enabled. [Critical, Warning, Info]\n - alerting_check_times (integer) — Number of consecutive evaluations that must satisfy the condition before alerting; minimum 1.\n - enabled (boolean) — Whether no-data checking is enabled: a previously-seen series that stops returning data triggers an alert.\n - push_recovery_event (boolean) — Whether to push a recovery event notification when the alert resolves.\n - recovery_check_times (integer) — Number of consecutive evaluations that must satisfy the recovery condition before resolving; minimum 1.\n - resolve_timeout (integer) — Auto-resolve after N seconds.\n - severity (string) — Severity of no-data alert events; case-sensitive. [Critical, Warning, Info]\n - check_threshold (object) — Threshold check configuration.\n - alerting_check_times (integer) — Number of consecutive evaluations that must satisfy the condition before alerting; minimum 1.\n - critical (string) — Critical threshold expression referencing query results via `$` or `$.`, e.g. `$A > 90`; at least one severity must be configured.\n - enabled (boolean) — Whether threshold checking is enabled.\n - info (string) — Info threshold expression, same syntax as `critical`.\n - push_recovery_event (boolean) — Whether to push a recovery event notification when the alert resolves.\n - recovery (object) — Recovery evaluation configuration for threshold checks.\n - condition (string) — Recovery condition expression; required when `mode` is `threshold` or `ql`, and must be empty for `invert`.\n - mode (string) — Recovery mode: `invert` = resolve when the alert expression no longer holds (`condition` stays empty); `threshold` = resolve when the `condition` threshold expression holds; `ql` = resolve when the `condition` query expression evaluates true. [invert, threshold, ql]\n - recovery_check_times (integer) — Number of consecutive evaluations that must satisfy the recovery condition before resolving; minimum 1.\n - warning (string) — Warning threshold expression, same syntax as `critical`.\n - queries (array) — Query list with at least one entry; each needs a unique `name` (`R` and `__all__` are reserved) and a non-empty, non-duplicate `expr`.\n - args (object) — Datasource-specific query options keyed by the `.