From 52b37a70388adbcfb9f11c72e11832e4fec154ff Mon Sep 17 00:00:00 2001 From: ysyneu Date: Wed, 26 Aug 2026 08:36:02 -0700 Subject: [PATCH 1/3] fix: render unset timestamps as null in --json output go-flashduty's Timestamp.MarshalJSON emits a quoted RFC3339 string for a set value but the bare integer 0 for the unset sentinel, so one field switches JSON type depending on record state: an active alert's end_time is the number 0 while a recovered alert's is a string. jq arithmetic over mixed-state output fails with "string and number cannot be subtracted". Add output.NullUnsetInstants, a reflection-based transform applied at the JSON marshaling boundary (JSONPrinter.Print and marshalStructured), that replaces every unset SDK timestamp with nil so it renders as null. Set values keep their concrete type and custom MarshalJSON, non-timestamp zero integers are untouched, and struct field order is preserved (verified byte-identical when no unset instant is present). TOON and table output are unchanged: they render the sentinel through String(), already always a string. The generated help note and the skill card prose that documented the old "unset stays the bare integer 0" contract are updated to match. --- internal/cli/root.go | 7 +- internal/cli/zz_generated_a2a_agents.go | 8 +- internal/cli/zz_generated_account.go | 2 +- internal/cli/zz_generated_alert_enrichment.go | 40 +-- internal/cli/zz_generated_alert_rules.go | 14 +- internal/cli/zz_generated_alerts.go | 82 ++--- internal/cli/zz_generated_analytics.go | 18 +- internal/cli/zz_generated_applications.go | 12 +- internal/cli/zz_generated_audit_logs.go | 2 +- internal/cli/zz_generated_automations.go | 32 +- internal/cli/zz_generated_calendars.go | 12 +- internal/cli/zz_generated_changes.go | 14 +- internal/cli/zz_generated_channels.go | 52 ++-- internal/cli/zz_generated_data_sources.go | 8 +- internal/cli/zz_generated_diagnostics.go | 2 +- .../cli/zz_generated_error_ingestion_rules.go | 12 +- internal/cli/zz_generated_im_integrations.go | 6 +- internal/cli/zz_generated_incidents.go | 280 +++++++++--------- ...z_generated_issue_preset_severity_rules.go | 12 +- internal/cli/zz_generated_issues.go | 28 +- internal/cli/zz_generated_knowledge.go | 24 +- internal/cli/zz_generated_licenses.go | 4 +- internal/cli/zz_generated_mcp_servers.go | 16 +- internal/cli/zz_generated_members.go | 4 +- .../zz_generated_notification_templates.go | 12 +- internal/cli/zz_generated_resources.go | 10 +- internal/cli/zz_generated_response_help.go | 272 ++++++++--------- .../cli/zz_generated_roles_permissions.go | 8 +- internal/cli/zz_generated_rule_sets.go | 16 +- internal/cli/zz_generated_schedules.go | 160 +++++----- internal/cli/zz_generated_service_map.go | 38 +-- internal/cli/zz_generated_session_replay.go | 12 +- internal/cli/zz_generated_sessions.go | 34 +-- internal/cli/zz_generated_skills.go | 16 +- internal/cli/zz_generated_sourcemaps.go | 4 +- internal/cli/zz_generated_status_pages.go | 34 +-- internal/cli/zz_generated_teams.go | 8 +- internal/cmd/cligen/main.go | 2 +- internal/output/instant.go | 214 +++++++++++++ internal/output/instant_test.go | 174 +++++++++++ internal/output/json.go | 2 +- skills/flashduty/SKILL.md | 2 +- 42 files changed, 1049 insertions(+), 660 deletions(-) create mode 100644 internal/output/instant.go create mode 100644 internal/output/instant_test.go 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/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 `.