Adds the ability to filter users in the WPCOM_JSON_API_List_Users_End…

…point endpoint by capability (#36893)

* Adds the ability to filter users in the WPCOM_JSON_API_List_Users_Endpoint endpoint by capability

* Update doc

* Rename capabilities to capability and make it inclusive

projects/plugins/jetpack/changelog/add-list-users-endpoint-capabilities-filter

@@ -0,0 +1,4 @@
+Significance: minor
+Type: other
+
+Adds the ability to filter users in the WPCOM_JSON_API_List_Users_Endpoint endpoint by capability

projects/plugins/jetpack/json-endpoints/class.wpcom-json-api-list-users-endpoint.php

@@ -38,6 +38,7 @@
 			'search'          => '(string) Find matching users.',
 			'search_columns'  => "(array) Specify which columns to check for matching users. Can be any of 'ID', 'user_login', 'user_email', 'user_url', 'user_nicename', and 'display_name'. Only works when combined with `search` parameter.",
 			'role'            => '(string) Specify a specific user role to fetch.',
+			'capability'      => '(string) Specify a specific capability to fetch. You can specify multiple by comma separating them, in which case the user needs to match all capabilities provided.',
 		),
 
 		'response_format'      => array(
@@ -159,6 +160,10 @@ public function callback( $path = '', $blog_id = 0 ) {
 			$query['role'] = $args['role'];
 		}
 
+		if ( ! empty( $args['capability'] ) ) {
+			$query['capability'] = $args['capability'];
+		}
+
 		$user_query = new WP_User_Query( $query );
 
 		remove_filter( 'user_search_columns', array( $this, 'api_user_override_search_columns' ) );