@tailglow/cli 0.5.1 → 0.6.1

package/src/commands.generated.js

@@ -1794,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": [
@@ -1814,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": []
   },
   {
@@ -2008,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",
@@ -2024,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",
@@ -2134,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",
@@ -2142,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",
@@ -2207,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",
@@ -2223,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",
@@ -2350,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."
     ],
@@ -2375,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": []
   },
   {
@@ -2673,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
+          }
+        ]
       }
     ]
   },
@@ -2956,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
       }
@@ -3171,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": [
       {
@@ -3217,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."
     ],
@@ -3246,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",
@@ -3865,8 +4234,8 @@ export const CLI_COMMANDS = [
         "description": "Chart line interpolation style. Optional.",
         "allowed_values": [
           "linear",
-          "smooth",
-          "step"
+          "step",
+          "smooth"
         ],
         "deprecated": null
       },
@@ -3878,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",
@@ -4247,8 +4616,8 @@ export const CLI_COMMANDS = [
         "description": "Chart line interpolation style. Optional.",
         "allowed_values": [
           "linear",
-          "smooth",
-          "step"
+          "step",
+          "smooth"
         ],
         "deprecated": null
       },
@@ -4260,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",
@@ -4802,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`.",
@@ -4865,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",
@@ -5079,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",
@@ -5294,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",
@@ -6602,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
@@ -6785,8 +7154,8 @@ export const CLI_COMMANDS = [
         "description": "Account status for the team. Optional.",
         "allowed_values": [
           "active",
-          "restricted",
           "delinquent",
+          "restricted",
           "blocked"
         ],
         "deprecated": null
@@ -6813,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",
@@ -6892,8 +7319,8 @@ export const CLI_COMMANDS = [
         "description": "Account status for the team. Optional.",
         "allowed_values": [
           "active",
-          "restricted",
           "delinquent",
+          "restricted",
           "blocked"
         ],
         "deprecated": null
@@ -6905,8 +7332,8 @@ export const CLI_COMMANDS = [
         "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",
-          "restricted",
           "delinquent",
+          "restricted",
           "blocked"
         ],
         "deprecated": null
@@ -6941,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",
@@ -7676,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
@@ -7964,7 +8449,7 @@ export const CLI_COMMANDS = [
     "body_fields": []
   },
   {
-    "resource": "apiKeys",
+    "resource": "api_keys",
     "command": "list",
     "operation_id": "listApiKeys",
     "summary": "List API Keys",
@@ -8030,7 +8515,7 @@ export const CLI_COMMANDS = [
     "body_fields": []
   },
   {
-    "resource": "apiKeys",
+    "resource": "api_keys",
     "command": "retrieve",
     "operation_id": "getApiKey",
     "summary": "Retrieve API Key",
@@ -8056,7 +8541,7 @@ export const CLI_COMMANDS = [
     "body_fields": []
   },
   {
-    "resource": "apiKeys",
+    "resource": "api_keys",
     "command": "create",
     "operation_id": "createApiKey",
     "summary": "Create API Key",
@@ -8092,7 +8577,7 @@ export const CLI_COMMANDS = [
     ]
   },
   {
-    "resource": "apiKeys",
+    "resource": "api_keys",
     "command": "update",
     "operation_id": "updateApiKey",
     "summary": "Update API Key",
@@ -8137,7 +8622,7 @@ export const CLI_COMMANDS = [
     ]
   },
   {
-    "resource": "apiKeys",
+    "resource": "api_keys",
     "command": "delete",
     "operation_id": "deleteApiKey",
     "summary": "Delete API Key",
@@ -8145,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",