diff --git a/app/controllers/api/teams.php b/app/controllers/api/teams.php
index e173f5faac..0565131665 100644
--- a/app/controllers/api/teams.php
+++ b/app/controllers/api/teams.php
@@ -473,8 +473,8 @@ App::patch('/v1/teams/:teamId/memberships/:membershipId')
     ->label('sdk.response.type', Response::CONTENT_TYPE_JSON)
     ->label('sdk.response.model', Response::MODEL_MEMBERSHIP)
     ->param('teamId', '', new UID(), 'The unique team ID.')
-    ->param('membershipId', '', new UID(), 'Membership ID.')
-    ->param('roles', [], new ArrayList(new Key()), 'Array of strings. Use this param to set the user roles in the team. A role can be any string. Learn more about [roles and permissions](/docs/permissions). Max length for each role is 32 chars.')
+    ->param('membershipId', '', new UID(), 'The membership ID.')
+    ->param('roles', [], new ArrayList(new Key()), 'An array of strings. Use this param to set the user\'s roles in the team. A role can be any string. Learn more about [roles and permissions](/docs/permissions). Max length for each role is 32 chars.')
     ->inject('request')
     ->inject('response')
     ->inject('user')
diff --git a/docs/references/teams/update-team-membership-roles.md b/docs/references/teams/update-team-membership-roles.md
new file mode 100644
index 0000000000..add91638bb
--- /dev/null
+++ b/docs/references/teams/update-team-membership-roles.md
@@ -0,0 +1 @@
+Use this endpoint to modify the roles of a team member. Only team members with the owner role have access to this endpoint. Learn more about [roles and permissions](/docs/permissions)
\ No newline at end of file