diff --git a/awx/api/templates/api/team_roles_list.md b/awx/api/templates/api/team_roles_list.md
new file mode 100644
index 0000000000..a764cf8a14
--- /dev/null
+++ b/awx/api/templates/api/team_roles_list.md
@@ -0,0 +1,12 @@
+# List Roles for this Team:
+
+Make a GET request to this resource to retrieve a list of roles associated with the selected team.
+
+{% include "api/_list_common.md" %}
+
+# Associate Roles with this Team:
+
+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.