MediaWiki API help
This is an auto-generated MediaWiki API documentation page.
Documentation and examples: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=userrights
- This module requires read rights.
- This module requires write rights.
- This module only accepts POST requests.
- Source: MediaWiki
- License: GPL-2.0-or-later
Change a user's group membership.
- user
User.
- Type: user, by any of username and user ID (e.g. "#12345")
- userid
- Deprecated.
Specify user=#ID instead.
- Type: integer
- add
Add the user to these groups, or if they are already a member, update the expiry of their membership in that group.
- Values (separate with | or alternative): MW_Ops, SG_All_Contractors, SG_All_Employees, SG_All_Interns, SG_All_Sweden_Employees, SG_All_USA_Employees, SG_Batman_Administrator, SG_Batman_All, SG_Batman_Dev, SG_Copilot_All, SG_Copilot_Leadership, SG_Cumberland_All, SG_Cumberland_Leadership, SG_DevHiringManagers, SG_DraftKings_All, SG_Executive, SG_ExecutiveOps, SG_GTA_All, SG_Glacier_All, SG_Glacier_Leadership, SG_HR_All, SG_Helios_All, SG_Helios_Leadership, SG_HoHR_Developers, SG_HoHR_Developers_Admin, SG_KAI_All, SG_KAI_Leadership, SG_Lithonaut_All, SG_Lithonaut_Leadership, SG_Minecraft_All, SG_Minecraft_Dev, SG_NumbersGame_All, SG_NumbersGame_Leadership, SG_Ops_All, SG_Ops_USA, SG_PeopleManagers, SG_RapidFire_All, SG_RapidFire_Leadership, SG_Recruiting_All, SG_Recruiting_ExecOps, SG_Recruiting_USA, SG_Wizard_All, SG_Wizard_Leadership, SG_XLT, bot, bureaucrat, copyviobot, electionadmin, houser, interface-admin, pageproperties-admin, pageproperties-editor, smwadministrator, smwcurator, smweditor, suppress, sysop
- Maximum number of values is 50 (500 for clients that are allowed higher limits).
- expiry
Expiry timestamps. May be relative (e.g. 5 months or 2 weeks) or absolute (e.g. 2014-09-18T12:34:56Z). If only one timestamp is set, it will be used for all groups passed to the add parameter. Use infinite, indefinite, infinity, or never for a never-expiring user group.
- Separate values with | or alternative.
- Maximum number of values is 50 (500 for clients that are allowed higher limits).
- Default: infinite
- remove
Remove the user from these groups.
- Values (separate with | or alternative): MW_Ops, SG_All_Contractors, SG_All_Employees, SG_All_Interns, SG_All_Sweden_Employees, SG_All_USA_Employees, SG_Batman_Administrator, SG_Batman_All, SG_Batman_Dev, SG_Copilot_All, SG_Copilot_Leadership, SG_Cumberland_All, SG_Cumberland_Leadership, SG_DevHiringManagers, SG_DraftKings_All, SG_Executive, SG_ExecutiveOps, SG_GTA_All, SG_Glacier_All, SG_Glacier_Leadership, SG_HR_All, SG_Helios_All, SG_Helios_Leadership, SG_HoHR_Developers, SG_HoHR_Developers_Admin, SG_KAI_All, SG_KAI_Leadership, SG_Lithonaut_All, SG_Lithonaut_Leadership, SG_Minecraft_All, SG_Minecraft_Dev, SG_NumbersGame_All, SG_NumbersGame_Leadership, SG_Ops_All, SG_Ops_USA, SG_PeopleManagers, SG_RapidFire_All, SG_RapidFire_Leadership, SG_Recruiting_All, SG_Recruiting_ExecOps, SG_Recruiting_USA, SG_Wizard_All, SG_Wizard_Leadership, SG_XLT, bot, bureaucrat, copyviobot, electionadmin, houser, interface-admin, pageproperties-admin, pageproperties-editor, smwadministrator, smwcurator, smweditor, suppress, sysop
- Maximum number of values is 50 (500 for clients that are allowed higher limits).
- reason
Reason for the change.
- Default: (empty)
- token
A "userrights" token retrieved from action=query&meta=tokens
For compatibility, the token used in the web UI is also accepted.
- This parameter is required.
- tags
Change tags to apply to the entry in the user rights log.
- Values (separate with | or alternative):
- Add user FooBot to group bot, and remove from groups sysop and bureaucrat.
- api.php?action=userrights&user=FooBot&add=bot&remove=sysop|bureaucrat&token=123ABC [open in sandbox]
- Add the user with ID 123 to group bot, and remove from groups sysop and bureaucrat.
- api.php?action=userrights&userid=123&add=bot&remove=sysop|bureaucrat&token=123ABC [open in sandbox]
- Add user SometimeSysop to group sysop for 1 month.
- api.php?action=userrights&user=SometimeSysop&add=sysop&expiry=1%20month&token=123ABC [open in sandbox]