coder
diff --git a/‎coderd/apidoc/docs.go
Lines changed: 4 additions & 5 deletions b/‎coderd/apidoc/docs.go
Lines changed: 4 additions & 5 deletions
diff --git a/‎coderd/apidoc/swagger.json
Lines changed: 5 additions & 5 deletions b/‎coderd/apidoc/swagger.json
Lines changed: 5 additions & 5 deletions
diff --git a/‎codersdk/idpsync.go
Lines changed: 6 additions & 8 deletions b/‎codersdk/idpsync.go
Lines changed: 6 additions & 8 deletions
diff --git a/‎codersdk/workspaces.go
Lines changed: 1 addition & 1 deletion b/‎codersdk/workspaces.go
Lines changed: 1 addition & 1 deletion
diff --git a/‎docs/reference/api/builds.md
Lines changed: 1 addition & 1 deletion b/‎docs/reference/api/builds.md
Lines changed: 1 addition & 1 deletion
diff --git a/‎docs/reference/api/schemas.md
Lines changed: 8 additions & 9 deletions b/‎docs/reference/api/schemas.md
Lines changed: 8 additions & 9 deletions
@@ -12,11 +12,10 @@ import (
 )
 
 type GroupSyncSettings struct {
-	// Field selects the claim field to be used as the created user's
-	// groups. If the group field is the empty string, then no group updates
-	// will ever come from the OIDC provider.
+	// Field is the name of the claim field that specifies what groups a user
+	// should be in. If empty, no groups will be synced.
 	Field string `json:"field"`
-	// Mapping maps from an OIDC group --> Coder group ID
+	// Mapping is a map from OIDC groups to Coder group IDs
 	Mapping map[string][]uuid.UUID `json:"mapping"`
 	// RegexFilter is a regular expression that filters the groups returned by
 	// the OIDC provider. Any group not matched by this regex will be ignored.
@@ -62,11 +61,10 @@ func (c *Client) PatchGroupIDPSyncSettings(ctx context.Context, orgID string, re
 }
 
 type RoleSyncSettings struct {
-	// Field selects the claim field to be used as the created user's
-	// groups. If the group field is the empty string, then no group updates
-	// will ever come from the OIDC provider.
+	// Field is the name of the claim field that specifies what organization roles
+	// a user should be given. If empty, no roles will be synced.
 	Field string `json:"field"`
-	// Mapping maps from an OIDC group --> Coder organization role
+	// Mapping is a map from OIDC groups to Coder organization roles.
 	Mapping map[string][]string `json:"mapping"`
 }
 
 
@@ -93,7 +93,7 @@ const (
 // CreateWorkspaceBuildRequest provides options to update the latest workspace build.
 type CreateWorkspaceBuildRequest struct {
 	TemplateVersionID uuid.UUID           `json:"template_version_id,omitempty" format:"uuid"`
-	Transition        WorkspaceTransition `json:"transition" validate:"oneof=create start stop delete,required"`
+	Transition        WorkspaceTransition `json:"transition" validate:"oneof=start stop delete,required"`
 	DryRun            bool                `json:"dry_run,omitempty"`
 	ProvisionerState  []byte              `json:"state,omitempty"`
 	// Orphan may be set for the Destroy transition.