coder
diff --git a/‎coderd/apidoc/docs.go
Lines changed: 10 additions & 0 deletions b/‎coderd/apidoc/docs.go
Lines changed: 10 additions & 0 deletions
diff --git a/‎coderd/apidoc/swagger.json
Lines changed: 10 additions & 0 deletions b/‎coderd/apidoc/swagger.json
Lines changed: 10 additions & 0 deletions
diff --git a/‎codersdk/templates.go
Lines changed: 5 additions & 2 deletions b/‎codersdk/templates.go
Lines changed: 5 additions & 2 deletions
diff --git a/‎docs/api/enterprise.md
Lines changed: 4 additions & 4 deletions b/‎docs/api/enterprise.md
Lines changed: 4 additions & 4 deletions
diff --git a/‎docs/api/schemas.md
Lines changed: 10 additions & 10 deletions b/‎docs/api/schemas.md
Lines changed: 10 additions & 10 deletions
@@ -85,8 +85,11 @@ type TemplateUser struct {
 }
 
 type UpdateTemplateACL struct {
-	UserPerms  map[string]TemplateRole `json:"user_perms,omitempty"`
-	GroupPerms map[string]TemplateRole `json:"group_perms,omitempty"`
+	// UserPerms should be a mapping of user id to role. The user id must be the
+	// uuid of the user, not a username or email address.
+	UserPerms map[string]TemplateRole `json:"user_perms,omitempty" example:"<group_id>:admin,4df59e74-c027-470b-ab4d-cbba8963a5e9:use"`
+	// GroupPerms should be a mapping of group id to role.
+	GroupPerms map[string]TemplateRole `json:"group_perms,omitempty" example:"<user_id>>:admin,8bd26b20-f3e8-48be-a903-46bb920cf671:use"`
 }
 
 type UpdateTemplateMeta struct {
 
@@ -1080,12 +1080,12 @@ curl -X PATCH http://coder-server:8080/api/v2/templates/{template}/acl \
 ```json
 {
   "group_perms": {
-    "property1": "admin",
-    "property2": "admin"
+    "8bd26b20-f3e8-48be-a903-46bb920cf671": "use",
+    "<user_id>>": "admin"
   },
   "user_perms": {
-    "property1": "admin",
-    "property2": "admin"
+    "4df59e74-c027-470b-ab4d-cbba8963a5e9": "use",
+    "<group_id>": "admin"
   }
 }
 ```
 
@@ -4441,24 +4441,24 @@ AuthorizationObject can represent a "set" of objects, such as: all workspaces in
 ```json
 {
   "group_perms": {
-    "property1": "admin",
-    "property2": "admin"
+    "8bd26b20-f3e8-48be-a903-46bb920cf671": "use",
+    "<user_id>>": "admin"
   },
   "user_perms": {
-    "property1": "admin",
-    "property2": "admin"
+    "4df59e74-c027-470b-ab4d-cbba8963a5e9": "use",
+    "<group_id>": "admin"
   }
 }
 ```
 
 ### Properties
 
-| Name               | Type                                           | Required | Restrictions | Description |
-| ------------------ | ---------------------------------------------- | -------- | ------------ | ----------- |
-| `group_perms`      | object                                         | false    |              |             |
-| » `[any property]` | [codersdk.TemplateRole](#codersdktemplaterole) | false    |              |             |
-| `user_perms`       | object                                         | false    |              |             |
-| » `[any property]` | [codersdk.TemplateRole](#codersdktemplaterole) | false    |              |             |
+| Name               | Type                                           | Required | Restrictions | Description                                                                                                                   |
+| ------------------ | ---------------------------------------------- | -------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------- |
+| `group_perms`      | object                                         | false    |              | Group perms should be a mapping of group ID to role.                                                                          |
+| » `[any property]` | [codersdk.TemplateRole](#codersdktemplaterole) | false    |              |                                                                                                                               |
+| `user_perms`       | object                                         | false    |              | User perms should be a mapping of user ID to role. The user ID must be the uuid of the user, not a username or email address. |
+| » `[any property]` | [codersdk.TemplateRole](#codersdktemplaterole) | false    |              |                                                                                                                               |
 
 ## codersdk.UpdateUserPasswordRequest
Original file line number	Diff line number	Diff line change
`@@ -85,8 +85,11 @@ type TemplateUser struct {`
`85`	`85`	`}`
`86`	`86`
`87`	`87`	`type UpdateTemplateACL struct {`
`88`		- UserPerms map[string]TemplateRole `json:"user_perms,omitempty"`
`89`		- GroupPerms map[string]TemplateRole `json:"group_perms,omitempty"`
	`88`	`+ // UserPerms should be a mapping of user id to role. The user id must be the`
	`89`	`+ // uuid of the user, not a username or email address.`
	`90`	+ UserPerms map[string]TemplateRole `json:"user_perms,omitempty" example:"<group_id>:admin,4df59e74-c027-470b-ab4d-cbba8963a5e9:use"`
	`91`	`+ // GroupPerms should be a mapping of group id to role.`
	`92`	+ GroupPerms map[string]TemplateRole `json:"group_perms,omitempty" example:"<user_id>>:admin,8bd26b20-f3e8-48be-a903-46bb920cf671:use"`
`90`	`93`	`}`
`91`	`94`
`92`	`95`	`type UpdateTemplateMeta struct {`
Original file line number	Diff line number	Diff line change
`@@ -1080,12 +1080,12 @@ curl -X PATCH http://coder-server:8080/api/v2/templates/{template}/acl \`
`1080`	`1080`	```json
`1081`	`1081`	`{`
`1082`	`1082`	`"group_perms": {`
`1083`		`- "property1": "admin",`
`1084`		`- "property2": "admin"`
	`1083`	`+ "8bd26b20-f3e8-48be-a903-46bb920cf671": "use",`
	`1084`	`+ "<user_id>>": "admin"`
`1085`	`1085`	`},`
`1086`	`1086`	`"user_perms": {`
`1087`		`- "property1": "admin",`
`1088`		`- "property2": "admin"`
	`1087`	`+ "4df59e74-c027-470b-ab4d-cbba8963a5e9": "use",`
	`1088`	`+ "<group_id>": "admin"`
`1089`	`1089`	`}`
`1090`	`1090`	`}`
`1091`	`1091`	```