diff --git a/src/headless/plugins/muc/affiliations/api.js b/src/headless/plugins/muc/affiliations/api.js
index f1000e059..20f9ef6c5 100644
--- a/src/headless/plugins/muc/affiliations/api.js
+++ b/src/headless/plugins/muc/affiliations/api.js
@@ -12,14 +12,13 @@ export default {
         /**
          * Set the given affliation for the given JIDs in the specified MUCs
          *
-         * @param { ('outcast'|'member'|'admin'|'owner') } affiliation - The affiliation to be set
          * @param { String|Array<String> } muc_jids - The JIDs of the MUCs in
          *  which the affiliation should be set.
          * @param { Object[] } users - An array of objects representing users
          *  for whom the affiliation is to be set.
-         * @param { string } users[].jid - The JID of the user whose affiliation will change
-         * @param { Array } users[].affiliation - The new affiliation for this user
-         * @param { string } [users[].reason] - An optional reason for the affiliation change
+         * @param { String } users[].jid - The JID of the user whose affiliation will change
+         * @param { ('outcast'|'member'|'admin'|'owner') } users[].affiliation - The new affiliation for this user
+         * @param { String } [users[].reason] - An optional reason for the affiliation change
          */
         set (muc_jids, users) {
             users = !Array.isArray(users) ? [users] : users;
diff --git a/src/headless/plugins/muc/affiliations/utils.js b/src/headless/plugins/muc/affiliations/utils.js
index c8cfeeca0..fe6faedd7 100644
--- a/src/headless/plugins/muc/affiliations/utils.js
+++ b/src/headless/plugins/muc/affiliations/utils.js
@@ -67,7 +67,7 @@ export function setAffiliations (muc_jid, users) {
  * a separate stanza for each JID.
  * Related ticket: https://issues.prosody.im/345
  *
- * @param { String } affiliation - The affiliation
+ * @param { ('outcast'|'member'|'admin'|'owner') } affiliation - The affiliation to be set
  * @param { String|Array<String> } jids - The JID(s) of the MUCs in which the
  *  affiliations need to be set.
  * @param { object } members - A map of jids, affiliations and