@tailglow/cli 0.5.0 → 0.6.0

package/src/commands.generated.js

@@ -463,6 +463,97 @@ export const CLI_COMMANDS = [
     "query_params": [],
     "body_fields": []
   },
+  {
+    "resource": "projects",
+    "command": "usage",
+    "operation_id": "getProjectUsage",
+    "summary": "Retrieve Project Usage",
+    "description": "Retrieve how much the project stored over a time range.",
+    "method": "GET",
+    "path": "/v1/projects/:project_id/usage",
+    "alternate_paths": [],
+    "scopes": [
+      "projects:read"
+    ],
+    "notes": [
+      "Readings are taken hourly and are the same measurements the project is billed on. Gigabytes are logical (uncompressed) bytes.",
+      "`interval=day` returns the last reading of each UTC day rather than an average, so a row is what the project held when the day closed. Its `sampled_at` is that reading's own hour.",
+      "Readings start when Tailglow began recording them, so a range reaching further back returns nothing for the hours before that.",
+      "`start_at` must be earlier than `end_at`, and the range cannot be longer than 400 days."
+    ],
+    "path_params": [
+      {
+        "name": "project_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the project.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [
+      {
+        "name": "start_at",
+        "type": "ISODateString",
+        "required": true,
+        "description": "Start of the range, inclusive (ISO format).",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "end_at",
+        "type": "ISODateString",
+        "required": false,
+        "description": "End of the range, inclusive (ISO format, default: now). Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "interval",
+        "type": "string",
+        "required": false,
+        "description": "Reading cadence returned: every hourly reading, or one reading per UTC day. Optional. Defaults to `\"hour\"`.",
+        "allowed_values": [
+          "hour",
+          "day"
+        ],
+        "deprecated": null
+      }
+    ],
+    "body_fields": []
+  },
+  {
+    "resource": "projects",
+    "command": "attention",
+    "operation_id": "getProjectAttention",
+    "summary": "Retrieve Project Attention",
+    "description": "Retrieve everything in the project that is asking for a human right now.",
+    "method": "GET",
+    "path": "/v1/projects/:project_id/attention",
+    "alternate_paths": [],
+    "scopes": [
+      "projects:read"
+    ],
+    "notes": [
+      "An item appears only when Tailglow entered a state on its own. Anything a project chose, such as a paused pull, a paused drain, or a paused monitor, is never reported here.",
+      "`tier` orders the list. `losing_data` means requests are being refused right now, within the last 5 minutes: for a reason a retry cannot fix, or for capacity after at least 5 minutes of unbroken refusals. `firing` means a monitor or check the project set up is currently triggered, or a server has run under sustained heavy load. `stalled` means a pipeline stopped making progress and its data is going stale. `suspended` means Tailglow switched something off and it stays off until it is fixed. `resolved` means refusals that lost data have stopped; `ended_at` says when.",
+      "Items disappear the moment their condition clears, with one exception so a loss is not missed: refusals that stop stay as `resolved`, for up to 24 hours for a key or payload refusal and up to an hour for capacity. A refusal item's `count` covers that whole window, not only the current spell. Refusals only count as stopped once every running server that was refusing has reported since; until then the item stays `losing_data`. Readings from the project's servers are cached briefly, so a condition that just started can take up to a minute to appear.",
+      "Items cover only resources the caller's key or role can read: without a resource's read permission, its conditions are left out. Refusal and server load items need `servers:read`, and firing monitors need `alerts:read`.",
+      "Items are already ranked, most urgent first. One item covers each firing monitor, and each view's failing transforms, joins, or shape waits. The response is capped per condition so a project in a bad state returns a readable list rather than every affected resource."
+    ],
+    "path_params": [
+      {
+        "name": "project_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the project.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [],
+    "body_fields": []
+  },
   {
     "resource": "sources",
     "command": "list",
@@ -1703,6 +1794,7 @@ export const CLI_COMMANDS = [
     ],
     "notes": [
       "Documents are returned exactly as they were sent, minus Tailglow's own reserved envelope.",
+      "Paging is forward-only. Pass `pagination.next_cursor` back as `after` to get the next page; no `prev_cursor` is issued, and `before` returns the first page.",
       "`after` and `before` are mutually exclusive."
     ],
     "path_params": [
@@ -1723,7 +1815,43 @@ export const CLI_COMMANDS = [
         "deprecated": null
       }
     ],
-    "query_params": [],
+    "query_params": [
+      {
+        "name": "limit",
+        "type": "number",
+        "required": false,
+        "description": "Maximum number of items to return. Optional. Defaults to `25`. Minimum: `1`. Maximum: `200`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "after",
+        "type": "string",
+        "required": false,
+        "description": "Cursor from `pagination.next_cursor` of a previous response. Returns the resources after that page. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "before",
+        "type": "string",
+        "required": false,
+        "description": "Cursor from `pagination.prev_cursor` of a previous response. Returns the resources before that page. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "sort",
+        "type": "string",
+        "required": false,
+        "description": "Sort direction for the result set. Optional. Defaults to `\"desc\"`.",
+        "allowed_values": [
+          "asc",
+          "desc"
+        ],
+        "deprecated": null
+      }
+    ],
     "body_fields": []
   },
   {
@@ -1917,7 +2045,40 @@ export const CLI_COMMANDS = [
         "required": false,
         "description": "The fields this view produces. Can be left until transforms define it. Optional.",
         "allowed_values": [],
-        "deprecated": null
+        "deprecated": null,
+        "fields": [
+          {
+            "name": "name",
+            "type": "string",
+            "required": true,
+            "description": "Field name as it appears on the view's records. Minimum length: `1`. Maximum length: `128`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "type",
+            "type": "string",
+            "required": true,
+            "description": "Value type the field holds.",
+            "allowed_values": [
+              "string",
+              "number",
+              "boolean",
+              "date",
+              "array",
+              "null"
+            ],
+            "deprecated": null
+          },
+          {
+            "name": "description",
+            "type": "string",
+            "required": false,
+            "description": "What the field means. Used as guidance when a transform script is generated. Optional. Maximum length: `512`.",
+            "allowed_values": [],
+            "deprecated": null
+          }
+        ]
       },
       {
         "name": "hint",
@@ -1933,7 +2094,41 @@ export const CLI_COMMANDS = [
         "required": false,
         "description": "Optional.",
         "allowed_values": [],
-        "deprecated": null
+        "deprecated": null,
+        "fields": [
+          {
+            "name": "nullable_inputs",
+            "type": "string[]",
+            "required": false,
+            "description": "Read paths explicitly permitted to be null. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "fallback_groups",
+            "type": "string[][]",
+            "required": false,
+            "description": "Approved ordered fallback read paths. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "output_bindings",
+            "type": "object",
+            "required": false,
+            "description": "Required source path segments for each output binding. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "allow_drops",
+            "type": "boolean",
+            "required": false,
+            "description": "Allow a validated mapping to emit no output for a record. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          }
+        ]
       },
       {
         "name": "project_id",
@@ -2043,7 +2238,70 @@ export const CLI_COMMANDS = [
         "required": true,
         "description": "Views joined onto the base view, each with its own match fields.",
         "allowed_values": [],
-        "deprecated": null
+        "deprecated": null,
+        "fields": [
+          {
+            "name": "lookup_view_id",
+            "type": "string",
+            "required": true,
+            "description": "View this clause looks values up in. Minimum length: `1`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "alias",
+            "type": "string",
+            "required": true,
+            "description": "Name this clause's fields are addressed by in the transform script. Minimum length: `1`. Maximum length: `64`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "join_type",
+            "type": "string",
+            "required": false,
+            "description": "How unmatched base records are handled. `left` keeps them with empty lookup fields, `inner` drops them. Optional. Defaults to `\"left\"`.",
+            "allowed_values": [
+              "left",
+              "inner"
+            ],
+            "deprecated": null
+          },
+          {
+            "name": "base_field",
+            "type": "string",
+            "required": true,
+            "description": "Field on the base view to match on. Minimum length: `1`. Maximum length: `256`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "lookup_field",
+            "type": "string",
+            "required": true,
+            "description": "Field on the lookup view to match against. Minimum length: `1`. Maximum length: `256`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "match_strategy",
+            "type": "string",
+            "required": false,
+            "description": "Which lookup record wins when several match. `latest` keeps the newest record timestamp and is the only supported value today. Optional. Defaults to `\"latest\"`.",
+            "allowed_values": [
+              "latest"
+            ],
+            "deprecated": null
+          },
+          {
+            "name": "priority",
+            "type": "integer",
+            "required": false,
+            "description": "Order this clause is applied in. Lower runs first. Optional. Defaults to `0`. Minimum: `0`.",
+            "allowed_values": [],
+            "deprecated": null
+          }
+        ]
       },
       {
         "name": "output_schema",
@@ -2051,7 +2309,40 @@ export const CLI_COMMANDS = [
         "required": false,
         "description": "Fields the join produces. Leave empty to have one inferred. Optional. Defaults to `[]`.",
         "allowed_values": [],
-        "deprecated": null
+        "deprecated": null,
+        "fields": [
+          {
+            "name": "name",
+            "type": "string",
+            "required": true,
+            "description": "Field name as it appears on the view's records. Minimum length: `1`. Maximum length: `128`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "type",
+            "type": "string",
+            "required": true,
+            "description": "Value type the field holds.",
+            "allowed_values": [
+              "string",
+              "number",
+              "boolean",
+              "date",
+              "array",
+              "null"
+            ],
+            "deprecated": null
+          },
+          {
+            "name": "description",
+            "type": "string",
+            "required": false,
+            "description": "What the field means. Used as guidance when a transform script is generated. Optional. Maximum length: `512`.",
+            "allowed_values": [],
+            "deprecated": null
+          }
+        ]
       },
       {
         "name": "transform_script",
@@ -2116,7 +2407,41 @@ export const CLI_COMMANDS = [
         "required": false,
         "description": "Optional.",
         "allowed_values": [],
-        "deprecated": null
+        "deprecated": null,
+        "fields": [
+          {
+            "name": "nullable_inputs",
+            "type": "string[]",
+            "required": false,
+            "description": "Read paths explicitly permitted to be null. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "fallback_groups",
+            "type": "string[][]",
+            "required": false,
+            "description": "Approved ordered fallback read paths. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "output_bindings",
+            "type": "object",
+            "required": false,
+            "description": "Required source path segments for each output binding. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "allow_drops",
+            "type": "boolean",
+            "required": false,
+            "description": "Allow a validated mapping to emit no output for a record. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          }
+        ]
       },
       {
         "name": "name",
@@ -2132,7 +2457,40 @@ export const CLI_COMMANDS = [
         "required": false,
         "description": "The fields this view produces. Can be left until transforms define it. Optional.",
         "allowed_values": [],
-        "deprecated": null
+        "deprecated": null,
+        "fields": [
+          {
+            "name": "name",
+            "type": "string",
+            "required": true,
+            "description": "Field name as it appears on the view's records. Minimum length: `1`. Maximum length: `128`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "type",
+            "type": "string",
+            "required": true,
+            "description": "Value type the field holds.",
+            "allowed_values": [
+              "string",
+              "number",
+              "boolean",
+              "date",
+              "array",
+              "null"
+            ],
+            "deprecated": null
+          },
+          {
+            "name": "description",
+            "type": "string",
+            "required": false,
+            "description": "What the field means. Used as guidance when a transform script is generated. Optional. Maximum length: `512`.",
+            "allowed_values": [],
+            "deprecated": null
+          }
+        ]
       },
       {
         "name": "hint",
@@ -2259,10 +2617,8 @@ export const CLI_COMMANDS = [
       "views:read"
     ],
     "notes": [
-      "Records are only filterable on fields that have a facet. Filtering on any other field is rejected, so create a facet for a field before querying it.",
       "Paging is forward-only. Pass `pagination.next_cursor` back as `after` to get the next page; a null `next_cursor` means there is nothing more to read. No `prev_cursor` is issued, and `before` is ignored.",
-      "A cursor is only valid for the query that produced it. Changing the sort direction, the filter, or (on a filtered read) the time range and reusing an older cursor returns a 400 rather than a page of skipped or repeated records, so start again without a cursor after any of those change.",
-      "`start_at` and `end_at` narrow a filtered read only. An unfiltered read returns the view's records regardless of the window, so pass a facet filter when you need a time-bounded result.",
+      "A cursor is only valid for the query that produced it. Reusing one after changing the sort direction returns a 400 rather than a page of skipped or repeated records, so start again without a cursor.",
       "A cursor stays valid while Tailglow reorganizes stored data in the background, so a paging client is never interrupted by storage maintenance. It is a position in this result set, not a snapshot: records that arrive while you page appear only if they sort after your position.",
       "`after` and `before` are mutually exclusive."
     ],
@@ -2284,7 +2640,43 @@ export const CLI_COMMANDS = [
         "deprecated": null
       }
     ],
-    "query_params": [],
+    "query_params": [
+      {
+        "name": "limit",
+        "type": "number",
+        "required": false,
+        "description": "Maximum number of items to return. Optional. Defaults to `25`. Minimum: `1`. Maximum: `200`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "after",
+        "type": "string",
+        "required": false,
+        "description": "Cursor from `pagination.next_cursor` of a previous response. Returns the resources after that page. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "before",
+        "type": "string",
+        "required": false,
+        "description": "Cursor from `pagination.prev_cursor` of a previous response. Returns the resources before that page. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "sort",
+        "type": "string",
+        "required": false,
+        "description": "Sort direction for the result set. Optional. Defaults to `\"desc\"`.",
+        "allowed_values": [
+          "asc",
+          "desc"
+        ],
+        "deprecated": null
+      }
+    ],
     "body_fields": []
   },
   {
@@ -2582,7 +2974,41 @@ export const CLI_COMMANDS = [
         "required": false,
         "description": "Explicit null, fallback, drop, and source-binding rules. Optional.",
         "allowed_values": [],
-        "deprecated": null
+        "deprecated": null,
+        "fields": [
+          {
+            "name": "nullable_inputs",
+            "type": "string[]",
+            "required": false,
+            "description": "Read paths explicitly permitted to be null. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "fallback_groups",
+            "type": "string[][]",
+            "required": false,
+            "description": "Approved ordered fallback read paths. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "output_bindings",
+            "type": "object",
+            "required": false,
+            "description": "Required source path segments for each output binding. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "allow_drops",
+            "type": "boolean",
+            "required": false,
+            "description": "Allow a validated mapping to emit no output for a record. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          }
+        ]
       }
     ]
   },
@@ -2865,9 +3291,9 @@ export const CLI_COMMANDS = [
       },
       {
         "name": "version_id",
-        "type": "string",
+        "type": "integer",
         "required": true,
-        "description": "Unique identifier of the version.",
+        "description": "The schema version number: the `version` a view version carries.",
         "allowed_values": [],
         "deprecated": null
       }
@@ -3080,7 +3506,7 @@ export const CLI_COMMANDS = [
     "notes": [
       "Use this after editing a script so existing records pick up the new logic. Without it, an edit only affects records that arrive afterwards.",
       "The re-backfill runs in the background and replaces the view's output as it progresses. Anything reading the view sees a mix of old and new values until it finishes.",
-      "Metrics and views that depend on this one are rebuilt as well."
+      "Refused while a metric, derived view or join view depends on this view."
     ],
     "path_params": [
       {
@@ -3126,6 +3552,7 @@ export const CLI_COMMANDS = [
     "notes": [
       "This is the schema-change path: it updates the output schema and re-queues the view's transforms in one step, so the scripts are rewritten to produce the new fields.",
       "Existing records keep their old shape until the regenerated transforms backfill over them.",
+      "Refused while a metric, derived view or join view depends on this view.",
       "`output_schema` field names must be unique by name, cannot conflict on type, and cannot collide with a reserved query key such as `limit` or `cursor`.",
       "Use `hint` for rules the generator cannot read off the field names: a formatting rule (\"display_name should be Name (Type)\"), a business threshold (\"classify as high above 500\"), or a disambiguation when a source field could map more than one way. Skip it for obvious mappings like renames and type conversions, which the generator already handles."
     ],
@@ -3155,7 +3582,40 @@ export const CLI_COMMANDS = [
         "required": false,
         "description": "The fields the view should produce. Omit to regenerate against the current schema. Optional.",
         "allowed_values": [],
-        "deprecated": null
+        "deprecated": null,
+        "fields": [
+          {
+            "name": "name",
+            "type": "string",
+            "required": true,
+            "description": "Field name as it appears on the view's records. Minimum length: `1`. Maximum length: `128`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "type",
+            "type": "string",
+            "required": true,
+            "description": "Value type the field holds.",
+            "allowed_values": [
+              "string",
+              "number",
+              "boolean",
+              "date",
+              "array",
+              "null"
+            ],
+            "deprecated": null
+          },
+          {
+            "name": "description",
+            "type": "string",
+            "required": false,
+            "description": "What the field means. Used as guidance when a transform script is generated. Optional. Maximum length: `512`.",
+            "allowed_values": [],
+            "deprecated": null
+          }
+        ]
       },
       {
         "name": "hint",
@@ -3774,8 +4234,8 @@ export const CLI_COMMANDS = [
         "description": "Chart line interpolation style. Optional.",
         "allowed_values": [
           "linear",
-          "smooth",
-          "step"
+          "step",
+          "smooth"
         ],
         "deprecated": null
       },
@@ -3787,12 +4247,12 @@ export const CLI_COMMANDS = [
         "allowed_values": [
           "count",
           "average",
+          "sum",
           "min",
           "max",
-          "sum",
           "last",
-          "cumulative_count",
           "cumulative_sum",
+          "cumulative_count",
           "p50",
           "p95",
           "p99",
@@ -4156,8 +4616,8 @@ export const CLI_COMMANDS = [
         "description": "Chart line interpolation style. Optional.",
         "allowed_values": [
           "linear",
-          "smooth",
-          "step"
+          "step",
+          "smooth"
         ],
         "deprecated": null
       },
@@ -4169,12 +4629,12 @@ export const CLI_COMMANDS = [
         "allowed_values": [
           "count",
           "average",
+          "sum",
           "min",
           "max",
-          "sum",
           "last",
-          "cumulative_count",
           "cumulative_sum",
+          "cumulative_count",
           "p50",
           "p95",
           "p99",
@@ -4711,7 +5171,7 @@ export const CLI_COMMANDS = [
       "monitors:write"
     ],
     "notes": [
-      "The monitor starts evaluating on its schedule as soon as it is created.",
+      "The monitor starts evaluating on its schedule as soon as it is created, unless it is created with `status` set to `paused`.",
       "`scope` decides how many alerts a monitor can raise at once: `any_series` fires once for the metric as a whole, `each_series` tracks every series separately.",
       "No-data (`absence`) conditions require `chart_value=count` and a finite `time_window_minutes`.",
       "`sustained_minutes` is required when `condition_type` is `sustained`, and `threshold_value` is required when it is `threshold`.",
@@ -4774,12 +5234,12 @@ export const CLI_COMMANDS = [
         "allowed_values": [
           "count",
           "average",
+          "sum",
           "min",
           "max",
-          "sum",
           "last",
-          "cumulative_count",
           "cumulative_sum",
+          "cumulative_count",
           "p50",
           "p95",
           "p99",
@@ -4988,12 +5448,12 @@ export const CLI_COMMANDS = [
         "allowed_values": [
           "count",
           "average",
+          "sum",
           "min",
           "max",
-          "sum",
           "last",
-          "cumulative_count",
           "cumulative_sum",
+          "cumulative_count",
           "p50",
           "p95",
           "p99",
@@ -5203,12 +5663,12 @@ export const CLI_COMMANDS = [
         "allowed_values": [
           "count",
           "average",
+          "sum",
           "min",
           "max",
-          "sum",
           "last",
-          "cumulative_count",
           "cumulative_sum",
+          "cumulative_count",
           "p50",
           "p95",
           "p99",
@@ -6511,8 +6971,8 @@ export const CLI_COMMANDS = [
         "description": "Filter by team status, written as `operator:value`. For example `equals:active` or `in:active,delinquent`. Optional.",
         "allowed_values": [
           "active",
-          "restricted",
           "delinquent",
+          "restricted",
           "blocked"
         ],
         "deprecated": null
@@ -6694,8 +7154,8 @@ export const CLI_COMMANDS = [
         "description": "Account status for the team. Optional.",
         "allowed_values": [
           "active",
-          "restricted",
           "delinquent",
+          "restricted",
           "blocked"
         ],
         "deprecated": null
@@ -6722,7 +7182,65 @@ export const CLI_COMMANDS = [
         "required": false,
         "description": "Billing address printed on invoices. Optional.",
         "allowed_values": [],
-        "deprecated": null
+        "deprecated": null,
+        "fields": [
+          {
+            "name": "thoroughfare",
+            "type": "string",
+            "required": false,
+            "description": "Optional. Maximum length: `128`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "premise",
+            "type": "string",
+            "required": false,
+            "description": "Optional. Maximum length: `128`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "sublocality",
+            "type": "string",
+            "required": false,
+            "description": "Optional. Maximum length: `128`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "locality",
+            "type": "string",
+            "required": false,
+            "description": "Optional. Maximum length: `128`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "administrative_area",
+            "type": "string",
+            "required": false,
+            "description": "Optional. Maximum length: `128`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "postal_code",
+            "type": "string",
+            "required": false,
+            "description": "Optional. Maximum length: `16`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "country",
+            "type": "string",
+            "required": false,
+            "description": "Optional. Minimum length: `2`. Maximum length: `2`.",
+            "allowed_values": [],
+            "deprecated": null
+          }
+        ]
       },
       {
         "name": "logo_url",
@@ -6749,6 +7267,7 @@ export const CLI_COMMANDS = [
       "At least one field must be provided.",
       "Only team Owners can change billing, security, or account settings. Other members can update `name` and `logo_url` only.",
       "`status`, `max_servers_per_project`, and `deleted_at` are managed by Tailglow and cannot be set by team members.",
+      "`status` requires `expected_status`, the status you loaded; the change is refused with a conflict if the team's status has changed since.",
       "Changing `is_mfa_required` requires a recently verified multi-factor sign-in.",
       "Moving to a plan that bills a payment method requires a valid payment method on the team.",
       "`billing_email` cannot use the `@tailglow.io` domain.",
@@ -6800,8 +7319,21 @@ export const CLI_COMMANDS = [
         "description": "Account status for the team. Optional.",
         "allowed_values": [
           "active",
+          "delinquent",
           "restricted",
+          "blocked"
+        ],
+        "deprecated": null
+      },
+      {
+        "name": "expected_status",
+        "type": "TeamStatus",
+        "required": false,
+        "description": "The status the team had when you loaded it. Required with `status`; the change is refused if the status has changed since. Optional.",
+        "allowed_values": [
+          "active",
           "delinquent",
+          "restricted",
           "blocked"
         ],
         "deprecated": null
@@ -6836,7 +7368,65 @@ export const CLI_COMMANDS = [
         "required": false,
         "description": "Billing address printed on invoices. Optional.",
         "allowed_values": [],
-        "deprecated": null
+        "deprecated": null,
+        "fields": [
+          {
+            "name": "thoroughfare",
+            "type": "string",
+            "required": false,
+            "description": "Optional. Maximum length: `128`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "premise",
+            "type": "string",
+            "required": false,
+            "description": "Optional. Maximum length: `128`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "sublocality",
+            "type": "string",
+            "required": false,
+            "description": "Optional. Maximum length: `128`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "locality",
+            "type": "string",
+            "required": false,
+            "description": "Optional. Maximum length: `128`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "administrative_area",
+            "type": "string",
+            "required": false,
+            "description": "Optional. Maximum length: `128`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "postal_code",
+            "type": "string",
+            "required": false,
+            "description": "Optional. Maximum length: `16`.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "country",
+            "type": "string",
+            "required": false,
+            "description": "Optional. Minimum length: `2`. Maximum length: `2`.",
+            "allowed_values": [],
+            "deprecated": null
+          }
+        ]
       },
       {
         "name": "logo_url",
@@ -7571,8 +8161,8 @@ export const CLI_COMMANDS = [
         "description": "Filter by team status, written as `operator:value`. For example `equals:active` or `in:active,delinquent`. Optional.",
         "allowed_values": [
           "active",
-          "restricted",
           "delinquent",
+          "restricted",
           "blocked"
         ],
         "deprecated": null
@@ -7859,7 +8449,7 @@ export const CLI_COMMANDS = [
     "body_fields": []
   },
   {
-    "resource": "apiKeys",
+    "resource": "api_keys",
     "command": "list",
     "operation_id": "listApiKeys",
     "summary": "List API Keys",
@@ -7925,7 +8515,7 @@ export const CLI_COMMANDS = [
     "body_fields": []
   },
   {
-    "resource": "apiKeys",
+    "resource": "api_keys",
     "command": "retrieve",
     "operation_id": "getApiKey",
     "summary": "Retrieve API Key",
@@ -7951,7 +8541,7 @@ export const CLI_COMMANDS = [
     "body_fields": []
   },
   {
-    "resource": "apiKeys",
+    "resource": "api_keys",
     "command": "create",
     "operation_id": "createApiKey",
     "summary": "Create API Key",
@@ -7987,7 +8577,7 @@ export const CLI_COMMANDS = [
     ]
   },
   {
-    "resource": "apiKeys",
+    "resource": "api_keys",
     "command": "update",
     "operation_id": "updateApiKey",
     "summary": "Update API Key",
@@ -8032,7 +8622,7 @@ export const CLI_COMMANDS = [
     ]
   },
   {
-    "resource": "apiKeys",
+    "resource": "api_keys",
     "command": "delete",
     "operation_id": "deleteApiKey",
     "summary": "Delete API Key",
@@ -8040,10 +8630,10 @@ export const CLI_COMMANDS = [
     "method": "DELETE",
     "path": "/v1/keys/:key_id",
     "alternate_paths": [],
-    "scopes": [
-      "keys:delete"
+    "scopes": [],
+    "notes": [
+      "Deleting a key needs `keys:delete`, except that a key can always delete itself. `tglow logout` uses this to remove the key it signed in with."
     ],
-    "notes": [],
     "path_params": [
       {
         "name": "key_id",
@@ -10374,7 +10964,8 @@ export const CLI_COMMANDS = [
     "alternate_paths": [],
     "scopes": [],
     "notes": [
-      "You can retrieve your own authentication logs without `logs:read`. All other log reads require `logs:read`.",
+      "You can retrieve your own authentication logs without `logs:read`. Billing logs require `billing:read`; all other log reads require `logs:read`.",
+      "Without `type`, the list includes every type you can read. `admin_auth` logs exist only on Tailglow's own admin team.",
       "`after` and `before` are mutually exclusive."
     ],
     "path_params": [],
@@ -10429,7 +11020,8 @@ export const CLI_COMMANDS = [
         "allowed_values": [
           "auth",
           "admin_auth",
-          "audit"
+          "audit",
+          "billing"
         ],
         "deprecated": null
       },