Nick Vigilante
7301cee2c4
fix: list every enum value the API can return in the Swagger spec ( #30122 )
...
The API reference is generated from Swagger comments and struct tags,
and several `enums:"..."` tags narrowed a named enum type, so the docs
omitted values the server returns. For example, `User.status` listed
only `active` and `suspended`, not `dormant`, and
`TemplateVersion.warnings` listed `DEPRECATED_PARAMETERS`, which is not
a value of the type.
Remove 34 `enums` tags that narrow or duplicate a named type so the
referenced type's full value list is used. Tags that describe an
intentional subset stay: ACL role fields (which omit the `""` deleted
sentinel used only in update requests), `APIKey.scope`, and plain-string
fields. `Template.provisioner` keeps its tag because `.swaggo` replaces
`ProvisionerType` with `string`.
Also fix enum defects that break code generators:
- The provisioner jobs and daemons `status` query parameters listed
their enum twice (Swagger 2.0 requires unique `enum` items) or with the
wrong type. Both are now `[]codersdk.ProvisionerJobStatus` and
`[]codersdk.ProvisionerDaemonStatus`, matching what each handler parses,
including comma-separated values. The daemons route previously
documented job statuses, which the handler rejects with a 500.
- Replace the `_` zero placeholder of `WatchErrorCode` with `iota + 1`,
so the spec no longer lists 0 or `x-enum-varnames: ["_", ...]`. Wire
values are unchanged.
Where the narrowed tag hid values the server returns, the SDK type now
includes them: `LoginTypeOAuth2ProviderApp`, `BuildReasonAutodelete`,
and `MissingTemplateParameter` widen the generated TypeScript unions.
The dashboard attributes `autodelete` builds to Coder like other system
builds. `APIKey.login_type` and `AuthorizationCheck.action` set explicit
examples so the generated samples stay representative.
`TestSwaggerEnumsNotNarrowed` fails when a property's enum list drops
values of its named type (other than the 15 allowlisted intentional
subsets), lists a value the type lacks, or repeats a value.
Part of DOCS-1122, split from #30121 .
---
🤖 Built with AI assistance.
2026-11-10 17:42:30 -05:00
..
2026-11-03 12:34:49 +02:00
2025-06-20 13:16:55 -06:00
2026-11-05 09:48:48 +00:00
2026-11-10 07:39:54 +02:00
2026-11-10 07:39:54 +02:00
2026-09-29 11:48:52 +02:00
2026-09-11 01:48:56 +00:00
2026-11-10 17:42:30 -05:00
2026-10-07 11:43:19 +03:00
2026-09-02 11:29:35 +02:00
2026-10-18 12:58:39 +07:00
2026-08-21 23:46:27 -06:00
2026-10-15 14:20:44 -05:00
2023-10-30 19:44:29 +00:00
2026-06-26 07:24:21 -04:00
2026-06-25 15:41:09 -06:00
2026-10-13 07:57:56 +00:00
2026-11-10 17:42:30 -05:00
2026-10-16 00:21:40 -08:00
2026-10-05 16:52:36 -07:00
2026-11-10 09:30:21 -08:00
2026-10-13 07:57:56 +00:00
2026-01-29 13:50:15 +01:00
2026-10-09 16:42:41 -06:00
2026-10-13 07:57:56 +00:00
2026-09-16 14:52:21 -07:00
2026-10-19 14:37:36 +11:00
2026-11-06 13:10:50 -05:00
2026-10-28 09:13:17 -06:00
2026-08-21 23:46:27 -06:00
2026-11-05 09:45:21 -05:00
2026-10-19 17:59:18 +03:00
2026-10-29 11:05:54 +01:00
2026-10-18 18:46:46 +02:00
2026-10-22 16:37:05 +11:00
2024-05-13 14:37:51 -04:00
2026-07-30 08:37:45 +01:00
2026-04-02 23:51:02 +02:00
2026-10-28 09:17:10 -06:00
2026-08-10 14:43:16 -05:00
2026-11-04 10:32:03 -06:00
2025-06-17 09:00:32 -08:00
2026-08-11 11:04:51 -05:00
2026-10-22 13:58:42 +00:00
2026-08-25 08:12:00 -07:00
2026-09-17 18:14:08 +02:00
2026-10-11 19:57:49 +02:00
2026-10-30 15:52:22 +02:00
2026-11-06 13:12:49 +11:00
2026-10-14 12:35:48 -04:00
2026-10-19 17:59:18 +03:00
2026-10-02 16:40:24 -08:00
2026-01-08 15:24:11 +04:00
2026-08-25 16:40:41 +07:00
2026-06-10 02:18:44 -05:00
2026-11-05 15:16:40 -05:00
2026-10-21 14:07:02 -07:00
2026-11-04 09:59:50 -08:00
2026-08-03 15:56:56 -05:00
2026-10-15 17:40:00 -05:00
2026-10-26 21:48:36 +00:00
2026-10-15 14:20:44 -05:00
2026-07-07 09:18:30 -07:00
2026-07-07 09:18:30 -07:00
2026-11-11 00:06:42 +11:00
2026-09-23 20:08:31 +02:00
2026-09-09 10:16:24 +02:00
2026-07-06 23:00:09 +01:00
2026-09-11 16:03:44 +00:00
2026-09-11 16:03:44 +00:00
2026-09-29 09:20:31 +01:00
2026-05-27 11:58:43 +02:00
2026-09-29 09:20:31 +01:00
2026-09-29 09:20:31 +01:00
2026-05-25 18:04:12 +02:00
2026-09-14 13:47:48 -07:00
2026-10-07 11:43:19 +03:00
2026-10-07 11:43:19 +03:00
2026-05-05 02:54:03 +05:00
2026-05-28 18:37:57 +01:00
2026-08-19 19:46:23 +00:00
2026-09-11 01:48:56 +00:00
2026-08-06 09:18:46 -04:00
2026-08-06 09:18:46 -04:00
2026-08-06 09:18:46 -04:00
2026-07-07 10:42:01 +00:00
2026-11-03 23:03:37 +07:00
2026-11-03 23:03:37 +07:00
2026-10-13 19:15:16 +07:00
2026-10-27 16:23:59 +01:00
2026-10-05 12:52:10 -04:00
2026-10-19 11:32:26 +00:00
2026-10-23 19:32:08 +07:00
2026-10-23 19:32:08 +07:00
2026-11-09 15:55:17 +11:00
2026-10-19 11:32:26 +00:00
2026-10-29 23:24:18 +01:00
2026-10-30 15:52:22 +02:00
2026-07-01 20:15:03 +01:00
2026-09-14 08:31:26 -07:00
2026-10-29 20:32:56 +01:00
2026-07-14 12:29:38 -07:00
2026-08-18 12:54:45 -07:00
2026-08-24 12:06:56 -07:00
2026-08-21 23:46:27 -06:00
2026-09-24 15:12:28 +03:00
2026-05-05 02:54:03 +05:00
2026-05-05 02:54:03 +05:00
2026-10-30 19:07:36 +00:00
2026-10-30 20:27:10 +00:00
2026-11-09 15:55:17 +11:00
2026-10-29 23:24:18 +01:00
2026-11-04 12:15:55 +11:00
2026-09-21 17:42:31 +02:00
2026-10-30 20:15:50 +00:00
2026-08-24 11:20:26 +01:00
2026-08-26 13:33:13 +02:00
2026-10-30 15:52:22 +02:00
2026-09-21 15:58:18 +02:00
2026-10-30 15:52:22 +02:00
2026-10-07 15:55:04 +02:00
2026-11-09 17:26:10 +11:00
2026-10-27 01:50:56 +01:00
2026-11-09 15:55:17 +11:00
2026-10-29 20:32:56 +01:00
2026-10-29 20:32:56 +01:00
2026-09-29 12:23:00 +00:00
2026-10-19 14:02:47 +11:00
2026-07-15 12:16:25 -08:00
2026-08-19 13:00:31 -08:00
2026-06-02 10:11:49 -07:00
2026-08-18 12:54:45 -07:00
2026-06-02 08:36:01 -06:00
2026-07-06 13:15:58 +01:00
2026-10-06 13:01:11 +03:00
2026-10-06 13:01:11 +03:00
2026-03-23 19:54:43 +00:00
2026-05-05 02:54:03 +05:00
2026-09-25 18:51:55 +10:00
2026-09-25 18:51:55 +10:00
2026-10-23 12:53:39 +11:00
2026-10-19 17:59:18 +03:00
2026-10-26 21:48:36 +00:00
2026-10-27 10:15:44 +01:00
2026-10-30 20:27:10 +00:00
2026-10-14 14:55:29 -07:00
2026-11-03 12:39:30 +11:00
2026-11-03 12:39:30 +11:00
2026-10-09 00:58:39 +05:00
2026-10-09 00:58:39 +05:00
2026-10-09 00:58:39 +05:00
2026-11-03 12:39:30 +11:00
2026-08-26 15:29:26 +02:00
2026-08-26 15:29:26 +02:00
2026-05-05 02:54:03 +05:00
2026-09-16 11:36:45 -07:00
2026-09-28 18:46:14 +00:00
2026-08-26 11:57:56 -06:00
2026-09-14 18:31:48 -07:00
2026-09-14 18:31:48 -07:00
2026-09-28 18:46:14 +00:00
2026-09-22 23:20:24 +00:00
2026-11-05 14:22:30 -05:00
2026-05-05 02:54:03 +05:00
2026-10-29 12:53:50 +00:00
2026-10-29 12:53:50 +00:00
2026-10-13 16:43:15 +00:00
2026-10-30 20:15:50 +00:00
2026-10-13 16:24:45 +00:00
2026-10-23 19:32:08 +07:00
2026-09-08 17:20:53 +00:00
2026-09-17 14:33:37 -05:00
2026-08-21 10:31:01 -04:00
2026-08-21 10:31:01 -04:00
2026-05-05 02:54:03 +05:00
2026-11-10 17:42:30 -05:00
2026-06-03 10:46:07 +01:00
2026-04-10 09:50:11 -05:00
2026-11-10 17:42:30 -05:00
2024-07-25 16:07:53 -05:00
2026-09-27 23:34:26 +02:00
2026-05-05 02:54:03 +05:00
2026-05-05 02:54:03 +05:00
2026-10-14 14:55:29 -07:00
2026-10-14 14:55:29 -07:00
2026-10-14 14:55:29 -07:00
2026-09-02 12:51:33 -04:00
2026-09-10 08:21:29 -04:00
2026-09-10 08:21:29 -04:00
2026-09-11 18:13:16 -05:00
2026-09-11 18:13:16 -05:00
2026-09-17 11:11:38 +10:00
2026-09-11 18:13:16 -05:00
2026-08-19 16:16:51 -06:00
2026-10-13 07:57:56 +00:00
2026-05-05 02:54:03 +05:00
2026-06-04 14:37:19 -04:00
2026-08-26 11:57:56 -06:00
2026-10-07 19:03:46 +02:00
2026-10-09 16:42:41 -06:00
2026-10-23 12:53:40 +11:00
2026-07-28 09:58:33 -06:00
2026-09-02 09:21:36 -07:00
2026-09-02 09:21:36 -07:00
2026-09-02 09:21:36 -07:00
2026-08-21 23:46:27 -06:00
2026-09-02 09:21:36 -07:00
2026-08-18 12:54:45 -07:00
2026-10-27 01:06:49 +01:00
2026-10-27 01:06:49 +01:00
2026-04-15 11:31:43 +02:00
2026-04-26 14:49:10 -07:00
2026-05-05 02:54:03 +05:00
2026-05-05 02:54:03 +05:00
2026-07-01 15:59:55 +03:00
2026-11-04 12:15:55 +11:00
2026-11-03 12:34:49 +02:00
2026-11-04 12:15:55 +11:00
2026-10-19 23:06:41 +03:00
2026-10-14 13:54:17 +03:00
2026-10-19 23:06:41 +03:00
2026-10-07 11:43:19 +03:00
2026-10-07 11:43:19 +03:00
2026-09-25 13:59:53 -05:00
2026-09-21 11:04:12 +00:00
2026-08-21 23:46:27 -06:00
2026-10-16 15:55:28 +00:00
2026-10-16 15:55:28 +00:00
2026-05-05 02:54:03 +05:00
2026-09-24 11:41:32 -07:00
2026-09-24 11:41:32 -07:00
2026-09-19 00:32:51 +02:00
2026-08-26 11:57:56 -06:00
2026-11-03 15:48:10 -06:00
2026-11-03 15:48:10 -06:00
2026-10-15 17:40:00 -05:00
2026-09-21 21:06:06 +02:00