diff --git a/awx/api/templates/api/team_roles_list.md b/awx/api/templates/api/team_roles_list.md
index a764cf8a14..bf5bc24917 100644
--- a/awx/api/templates/api/team_roles_list.md
+++ b/awx/api/templates/api/team_roles_list.md
@@ -8,5 +8,5 @@ Make a GET request to this resource to retrieve a list of roles associated with
 
 Make a POST request to this resource to add or remove a role from this team. The following fields may be modified:
 
-   * `id`: Required. The Role ID to add to the team. 
-   * `disassociate`: Optional. Provide if you want to remove the role.
+   * `id`: The Role ID to add to the team. (int, required)
+   * `disassociate`: Provide if you want to remove the role. (any value, optional)
diff --git a/awx/api/templates/api/user_roles_list.md b/awx/api/templates/api/user_roles_list.md
index b4f6e3a9af..06c06cf1b3 100644
--- a/awx/api/templates/api/user_roles_list.md
+++ b/awx/api/templates/api/user_roles_list.md
@@ -8,5 +8,5 @@ Make a GET request to this resource to retrieve a list of roles associated with
 
 Make a POST request to this resource to add or remove a role from this user. The following fields may be modified:
 
-   * `id`: Required. The Role ID to add to the user. 
-   * `disassociate`: Optional. Provide if you want to remove the role.
+   * `id`: The Role ID to add to the user. (int, required)
+   * `disassociate`: Provide if you want to remove the role. (any value, optional)