auth0 4.4.0 → 5.1.2

data/lib/auth0/api/v2/organizations.rb

@@ -0,0 +1,335 @@
+module Auth0
+  module Api
+    module V2
+      # Methods to use the organizations endpoints
+      module Organizations
+        include Auth0::Mixins::Validation
+
+        attr_reader :organizations_path
+
+        # Get all organizations.
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/get_organizations
+        # @param options [hash] The Hash options used to define the paging of rersults
+        #   * :per_page [integer] The amount of entries per page. Default: 50. Max value: 100.
+        #   * :page [integer] The page number. Zero based.
+        #   * :include_totals [boolean] True to include query summary in the result, false or nil otherwise.
+        # @return [json] All Organizations
+        def organizations(options = {})
+          request_params = {
+            per_page:       options.fetch(:per_page, nil),
+            page:           options.fetch(:page, nil),
+            include_totals: options.fetch(:include_totals, nil)
+          }
+          get(organizations_path, request_params)
+        end
+        alias get_organizations organizations
+
+        # Create a new organization.
+        # @see ttps://auth0.com/docs/api/management/v2/#!/Organizations/post_organizations
+        # @param options [hash] See https://auth0.com/docs/api/management/v2/#!/Organizations/post_organizations for available options
+        # @return [json] Returns the created organization.
+        def create_organization(options = {})
+          post(organizations_path, options)
+        end
+
+        # Get an organization by id. A token with read:organizations scope is required
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/get_organizations_by_id
+        # @param organization_id [string] The organization_id of the user to retrieve.
+        #
+        # @return [json] Returns the organization with the given organization_id if it exists.
+        def organization(organization_id)
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          path = "#{organizations_path}/#{organization_id}"
+          get(path)
+        end
+
+        # Get an organization by name. A token with read:organizations scope is required.
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/get_name_by_name
+        # @param organization_name [string] The Organization name
+        #
+        # @return [json] Returns the organization with the given organization_name if it exists.
+        def organization_by_name(organization_name)
+          raise Auth0::InvalidParameter, 'Must supply a valid organization_name' if organization_name.to_s.empty?
+          path = "#{organizations_path}/name/#{organization_name}"
+          get(path)
+        end
+
+
+        # Deletes a single organization given its id
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/delete_organizations_by_id
+        # @param organization_id [string] The Organization ID
+        def delete_organization(organization_id)
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          path = "#{organizations_path}/#{organization_id}"
+          delete(path)
+        end
+
+        # Update an existing organization.
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/patch_organizations_by_id
+        # @param organization_id [string] The Organization ID
+        # @param body [hash] The optional parameters to update.
+        #
+        # @return [json] Returns the updated user.
+        def patch_organization(organization_id, body)
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply a valid body' if body.to_s.empty? || body.empty?
+          path = "#{organizations_path}/#{organization_id}"
+          patch(path, body)
+        end
+        alias update_organization patch_organization
+
+        ### Organization Enabled Connections
+
+        # Get enabled connections in an Organization
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/get_enabled_connections
+        # @param organization_id [string] The Organization ID
+        #
+        # @return [json] Returns the enabled connections for the given organization
+        def get_organizations_enabled_connections(organization_id)
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          path = "#{organizations_enabled_connections_path(organization_id)}"
+          get(path)
+        end
+
+        # Get enabled connection by id in an Organization
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/get_enabled_connections_by_connectionId
+        # @param organization_id [string] The Organization ID
+        # @param connection_id [string] The Connection id
+        #
+        # @return [json] Returns the connection for the given organization
+        def get_organizations_enabled_connection(organization_id, connection_id)
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply a valid connection id' if connection_id.to_s.empty?
+          path = "#{organizations_enabled_connections_path(organization_id)}/#{connection_id}"
+          get(path)
+        end
+
+        # Update an eanbled connection in an Organization
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/patch_enabled_connections_by_connectionId
+        # @param organization_id [string] The Organization ID
+        # @param connection_id [string] The Connection id
+        # @param assign_membership_on_login [boolean] flag to allow assign membership on login
+        #
+        # @return [json] Returns the connection for the given organization
+        def patch_organizations_enabled_connection(organization_id, connection_id, assign_membership_on_login: nil)
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply a valid connection id' if connection_id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply a valid assign_membership_on_login value' if assign_membership_on_login.nil?
+          path = "#{organizations_enabled_connections_path(organization_id)}/#{connection_id}"
+
+          body = {}
+          body[:assign_membership_on_login] = assign_membership_on_login
+
+          patch(path, body)
+        end
+        alias update_organizations_enabled_connection patch_organizations_enabled_connection
+
+        # Add an enabled connection for an Organization
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/post_enabled_connections
+        # @param organization_id [string] The Organization ID
+        # @param connection_id [string] The Organization ID
+        # @param assign_membership_on_login [boolean] flag to allow assign membership on login
+        #
+        # @return [json] Returns the connection for the given organization
+        def create_organizations_enabled_connection(organization_id, connection_id, assign_membership_on_login: false)
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply a valid connection id' if connection_id.to_s.empty?
+          path = "#{organizations_enabled_connections_path(organization_id)}"
+          
+          body = {}
+          body[:assign_membership_on_login] = assign_membership_on_login
+          body[:connection_id] = connection_id
+
+          post(path, body)
+        end
+        alias add_organizations_enabled_connection create_organizations_enabled_connection
+
+        # Remove an enabled connection from an Organization
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/delete_enabled_connections_by_connectionId
+        # @param organization_id [string] The Organization ID
+        # @param connection_id [string] The Connection id
+        def delete_organizations_enabled_connection(organization_id, connection_id)
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply a valid connection id' if connection_id.to_s.empty?
+          path = "#{organizations_enabled_connections_path(organization_id)}/#{connection_id}"
+          delete(path)
+        end
+        alias remove_organizations_enabled_connection delete_organizations_enabled_connection
+
+        ### Organization Invites
+
+        # Get invites in an Organization
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/get_invitations
+        # @param organization_id [string] The Organization ID
+        #
+        # @return [json] Returns the invites for the given organization
+        def get_organizations_invites(organization_id)
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          path = "#{organizations_invitations_path(organization_id)}"
+          get(path)
+        end
+
+        # Get invite by id in an Organization
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/get_invitations_by_invitation_id
+        # @param organization_id [string] The Organization ID
+        # @param invitation_id [string] The invitation id
+        #
+        # @return [json] Returns the invitation for the given organization
+        def get_organizations_invite(organization_id, invitation_id)
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply a valid invitation id' if invitation_id.to_s.empty?
+          path = "#{organizations_invitations_path(organization_id)}/#{invitation_id}"
+          get(path)
+        end
+
+        # Create an invitation in an organization
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/post_invitations
+        # @param organization_id [string] The Organization ID
+        # @param options [hash] See https://auth0.com/docs/api/management/v2/#!/Organizations/post_invitations
+        # @return [json] Returns the invitation for the given organization
+        def create_organizations_invite(organization_id, options = {})
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          path = "#{organizations_invitations_path(organization_id)}"
+          
+          post(path, options)
+        end
+        alias add_organizations_invite create_organizations_invite
+
+        # Delete an invitation to organization
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/delete_invitations_by_invitation_id
+        # @param organization_id [string] The Organization ID
+        # @param invitation_id [string] The Invitation id
+        def delete_organizations_invite(organization_id, invitation_id)
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply a valid invitation id' if invitation_id.to_s.empty?
+          path = "#{organizations_invitations_path(organization_id)}/#{invitation_id}"
+          delete(path)
+        end
+        alias remove_organizations_invite delete_organizations_invite
+
+        ### Organization Member
+
+        # Get Members in a Organization
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/get_members
+        # @param organization_id [string] The Organization ID
+        # @param user_id [string] The User ID
+        #
+        # @return [json] Returns the members for the given organization
+        def get_organizations_members(organization_id)
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          path = "#{organizations_members_path(organization_id)}"
+          get(path)
+        end
+
+        # Add members in an organization
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/post_members
+        # @param organization_id [string] The Organization ID
+        # @param members [array] Array of user IDs.
+        #
+        # @return [json] Returns the invitation for the given organization
+        def create_organizations_members(organization_id, members = [])
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply an array of member ids' if members.empty?
+          path = "#{organizations_members_path(organization_id)}"
+          
+          body = {}
+          body[:members] = members
+
+          post(path, body)
+        end
+        alias add_organizations_members create_organizations_members
+
+        # Remove members from an organization
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/delete_members
+        # @param organization_id [string] The Organization ID
+        # @param members [array] Array of user IDs.
+        def delete_organizations_members(organization_id, members = [])
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply an array of member ids' if members.empty?
+          path = "#{organizations_members_path(organization_id)}"
+
+          body = {}
+          body[:members] = members
+
+          delete(path, body)
+        end
+        alias remove_organizations_members delete_organizations_members
+
+        ### Organization Member Roles
+
+        # Get Roles assigned to a Member in an Organization
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/get_organization_member_roles
+        # @param organization_id [string] The Organization ID
+        # @param user_id [string] The User ID
+        #
+        # @return [json] Returns the member_roles for the given organization
+        def get_organizations_member_roles(organization_id, user_id)
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply a valid user id' if user_id.to_s.empty?
+          path = "#{organizations_member_roles_path(organization_id, user_id)}"
+          get(path)
+        end
+
+        # Assign roles to a member in an organization
+        # @see https://auth0.com/docs/api/management/v2/#!/Organizations/post_organization_member_roles
+        # @param organization_id [string] The Organization ID
+        # @param user_id [string] The User ID
+        # @param roles [array] Array of role IDs.
+        #
+        # @return [json] Returns the invitation for the given organization
+        def create_organizations_member_roles(organization_id, user_id, roles = [])
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply a valid user id' if user_id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply an array of role ids' if roles.empty?
+          path = "#{organizations_member_roles_path(organization_id, user_id)}"
+          
+          body = {}
+          body[:roles] = roles
+
+          post(path, body)
+        end
+        alias add_organizations_member_roles create_organizations_member_roles
+
+        # Remove roles from a Member of an organization
+        # @https://auth0.com/docs/api/management/v2/#!/Organizations/delete_organization_member_roles
+        # @param organization_id [string] The Organization ID
+        # @param user_id [string] The User ID
+        # @param roles [array] Array of role IDs.
+        def delete_organizations_member_roles(organization_id, user_id, roles = [])
+          raise Auth0::MissingOrganizationId, 'Must supply a valid organization_id' if organization_id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply a valid user id' if user_id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply an array of role ids' if roles.empty?
+          path = "#{organizations_member_roles_path(organization_id, user_id)}"
+                    
+          body = {}
+          body[:roles] = roles
+
+          delete(path, body)
+        end
+        alias remove_organizations_member_roles delete_organizations_member_roles
+
+        private
+        # Organizations API path
+        def organizations_path
+          @organizations_path ||= '/api/v2/organizations'
+        end
+
+        def organizations_enabled_connections_path(org_id)
+          "#{organizations_path}/#{org_id}/enabled_connections"
+        end
+
+        def organizations_members_path(org_id)
+          "#{organizations_path}/#{org_id}/members"
+        end
+
+        def organizations_member_roles_path(org_id, user_id)
+          "#{organizations_path}/#{org_id}/members/#{user_id}/roles"
+        end
+
+        def organizations_invitations_path(org_id)
+          "#{organizations_path}/#{org_id}/invitations"
+        end
+      end
+    end
+  end
+end

data/lib/auth0/api/v2/prompts.rb

@@ -0,0 +1,70 @@
+module Auth0
+  module Api
+    module V2
+      module Prompts
+        attr_reader :prompts_path
+
+        # Get prompts settings.
+        # @see https://auth0.com/docs/api/management/v2#!/Prompts/get_prompts
+        # @return [json] Returns the prompts setting.
+        def prompts
+          get(prompts_path)
+        end
+        alias get_prompts prompts
+
+        # Update prompts settings.
+        # @see https://auth0.com/docs/api/management/v2#!/Prompts/patch_prompts
+        # @param options [hash]
+        #   * :universal_login_experience [string] Should be any of: new, classic.
+        #
+        # @return [json] Returns the prompts settings.
+        def patch_prompts(options = {})
+          request_params = {
+            universal_login_experience: options.fetch(:universal_login_experience, nil)
+          }
+          patch(prompts_path, request_params)
+        end
+        alias update_prompts patch_prompts
+
+        # Get custom text for a prompt
+        # Retrieve custom text for a specific prompt and language.
+        # @see https://auth0.com/docs/api/management/v2#!/Prompts/get_custom_text_by_language
+        # @param prompt [string] Prompt of custom texts to update.
+        # @param language [string] Language of custom texts to update.
+        #
+        # @return [json] Returns the custom texts.
+        def custom_text(prompt, language)
+          raise Auth0::InvalidParameter, 'Must supply a valid prompt' if prompt.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply a valid language' if language.to_s.empty?
+
+          path = "#{prompts_path}/#{prompt}/custom-text/#{language}"
+          get(path)
+        end
+        alias get_custom_text custom_text
+
+        # Set custom text for a specific prompt
+        # Existing texts will be overwritten.
+        # @see https://auth0.com/docs/api/management/v2#!/Prompts/put_custom_text_by_language
+        # @param prompt [string] Prompt of custom texts to update.
+        # @param language [string] Language of custom texts to update.
+        # @param body [hash] Custom texts.
+        #
+        # @return [json] Returns the custom texts.
+        def put_custom_text(prompt, language, body)
+          raise Auth0::InvalidParameter, 'Must supply a valid prompt' if prompt.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must supply a valid language' if language.to_s.empty?
+
+          path = "#{prompts_path}/#{prompt}/custom-text/#{language}"
+          put(path, body)
+        end
+        alias update_custom_text put_custom_text
+
+        private
+
+        def prompts_path
+          @prompts_path ||= '/api/v2/prompts'
+        end
+      end
+    end
+  end
+end

data/lib/auth0/api/v2/resource_servers.rb

@@ -5,6 +5,20 @@ module Auth0
       module ResourceServers
         attr_reader :resource_servers_path
 
+        # Retrieves a list of all resource servers.
+        # @see https://auth0.com/docs/api/management/v2#!/Resource_servers/get_resource_servers
+        # @param page [int] Page number to get, 0-based.
+        # @param per_page [int] Results per page if also passing a page number.
+        # @return [json] Returns the resource servers.
+        def resource_servers(page: nil, per_page: nil)
+          request_params = {
+            page: !page.nil? ? page.to_i : nil,
+            per_page: !page.nil? && !per_page.nil? ? per_page.to_i : nil
+          }
+          get(resource_servers_path, request_params)
+        end
+        alias get_resource_servers resource_servers
+
         # Retrieves a resource server by its ID.
         # @see https://auth0.com/docs/api/management/v2#!/Resource_Servers/get_resource_servers_by_id
         # @param resource_server_id [string] The id of the resource server to retrieve.
@@ -21,18 +35,17 @@ module Auth0
         # Creates a new resource server according to the JSON object received in body.
         # @see https://auth0.com/docs/api/management/v2#!/Resource_Servers/post_resource_servers
         # @param identifier [string] The identifier of the resource server.
-        # @param name [string] The name of the resource server. Must contain at least one character.
-        # Does not allow '<' or '>'.
-        # @param signing_alg [string] The algorithm used to sign tokens.
-        # @param signing_secret [string] The secret used to sign tokens when using symmetric algorithms.
-        # @param token_lifetime [integer] The amount of time (in seconds) that the token will be valid
-        # after being issued.
-        # @param scopes [array] The scope of the resource server.
+        # @param options [hash]
+        #   * :name [string] The name of the resource server. Must contain at least one character. Does not allow '<' or '>'.
+        #   * :signing_alg [string] The algorithm used to sign tokens.
+        #   * :signing_secret [string] The secret used to sign tokens when using symmetric algorithms.
+        #   * :token_lifetime [integer] The amount of time (in seconds) that the token will be valid after being issued.
+        #   * :scopes [array] The scope of the resource server.
         #
         # @return [json] Returns the resource server.
         def create_resource_server(identifier, options = {})
           raise Auth0::InvalidParameter, 'Must supply a valid resource server id' if identifier.to_s.empty?
-          if ['<', '>'].include?(options.fetch(:name, ''))
+          if options.fetch(:name, '').index(/[<>]/)
             raise Auth0::InvalidParameter, 'Name must contain at least one character. Does not allow "<" or ">"'
           end
           request_params = Hash[options.map { |(k, v)| [k.to_sym, v] }]
@@ -49,6 +62,17 @@ module Auth0
           delete(path)
         end
 
+        # Updates a resource server.
+        # @see https://auth0.com/docs/api/management/v2#!/Resource_Servers/patch_resource_servers_by_id
+        # @param id [string] The id or audience of the resource server to update.
+        # @param body [hash] The Hash options used to define the resource servers's properties.
+        def patch_resource_server(id, body)
+          raise Auth0::InvalidParameter, 'Must specify a resource server id or audience' if id.to_s.empty?
+          raise Auth0::InvalidParameter, 'Must specify a valid body' if body.to_s.empty?
+          path = "#{resource_servers_path}/#{id}"
+          patch(path, body)
+        end
+        
         private
 
         # Resource Servers API path

data/lib/auth0/api/v2/roles.rb

@@ -0,0 +1,172 @@
+module Auth0
+  module Api
+    module V2
+      # Methods to use the Roles endpoints
+      module Roles
+        include Auth0::Mixins::Validation
+
+        # Get all Roles
+        # Required scope: "read:roles"
+        # @see https://auth0.com/docs/api/management/v2#!/Roles/get_roles
+        #
+        # @param options [hash] A hash of options for getting Roles
+        #   - per_page: Number of Roles to return.
+        #   - page: Page number to return, zero-based.
+        #   - include_totals: True to include query summary in the result, false or nil otherwise.
+        #   - name_filter: Optional filter on name (case-insensitive).
+        #
+        # @return [json] All Roles matching the query.
+        def get_roles(options = {})
+          request_params = {
+            per_page: options.fetch(:per_page, nil),
+            page: options.fetch(:page, nil),
+            include_totals: options.fetch(:include_totals, nil),
+            name_filter: options.fetch(:name_filter, nil)
+          }
+          get roles_path, request_params
+        end
+        alias roles get_roles
+
+        # Get a single Role by ID.
+        # Required scope: "read:roles"
+        # @see https://auth0.com/docs/api/management/v2#!/Roles/get_roles_by_id
+        #
+        # @param role_id [string] Role ID to get.
+        #
+        # @return [json] Role data.
+        def get_role(role_id)
+          raise Auth0::MissingParameter, 'Must supply a valid role_id' if role_id.to_s.empty?
+
+          get "#{roles_path}/#{role_id}"
+        end
+        alias role get_role
+
+        # Create a new Role.
+        # Required scope: "create:roles"
+        # @see https://auth0.com/docs/api/management/v2#!/Roles/post_roles
+        #
+        # @param role_name [string] Role name for the new Role.
+        # @param data [hash] Additional Role data.
+        def create_role(role_name, data = {})
+          raise Auth0::MissingParameter, 'Must supply a valid role_name' if role_name.to_s.empty?
+
+          data[:name] = role_name
+          post roles_path.to_s, data
+        end
+
+        # Update a Role by ID.
+        # Required scope: "update:roles"
+        # @see https://auth0.com/docs/api/management/v2#!/Roles/patch_roles_by_id
+        #
+        # @param role_id [string] Role ID to update.
+        # @param data [string] Role data to update.
+        def update_role(role_id, data = {})
+          raise Auth0::MissingParameter, 'Must supply a valid role_id' if role_id.to_s.empty?
+
+          patch "#{roles_path}/#{role_id}", data
+        end
+
+        # Delete a single Role by ID.
+        # Required scope: "delete:roles"
+        # @see https://auth0.com/docs/api/management/v2#!/Roles/delete_roles_by_id
+        #
+        # @param role_id [string] Role ID to delete.
+        def delete_role(role_id)
+          raise Auth0::MissingParameter, 'Must supply a valid role_id' if role_id.to_s.empty?
+
+          delete "#{roles_path}/#{role_id}"
+        end
+
+        # Get Users assigned to a specific Role.
+        # Required scopes:
+        #   - "read:roles"
+        #   - "read:users"
+        # @see https://auth0.com/docs/api/management/v2#!/Roles/get_role_user
+        #
+        # @param role_id [string] Role ID to which the Users belong to.
+        # @param options [hash] A hash of options for getting Roles
+        #   - per_page: Number of Roles to return.
+        #   - page: Page number to return, zero-based.
+        #   - include_totals: True to include query summary in the result, false or nil otherwise.
+        def get_role_users(role_id, options = {})
+          raise Auth0::MissingParameter, 'Must supply a valid role_id' if role_id.to_s.empty?
+
+          request_params = {
+            per_page: options.fetch(:per_page, nil),
+            page: options.fetch(:page, nil),
+            include_totals: options.fetch(:include_totals, nil)
+          }
+          get "#{roles_path}/#{role_id}/users", request_params
+        end
+
+        # Add one or more Users to a Role.
+        # Required scopes: "update:roles"
+        # @see https://auth0.com/docs/api/management/v2#!/Roles/post_role_users
+        #
+        # @param role_id [string] Role ID to add Users.
+        # @param users [array] Array of string User IDs to add to the Role.
+        def add_role_users(role_id, users = [])
+          raise Auth0::MissingParameter, 'Must supply a valid role_id' if role_id.to_s.empty?
+
+          validate_strings_array(users)
+          post "#{roles_path}/#{role_id}/users", users: users
+        end
+
+        # Get the permissions associated to a Role.
+        # Required scope: "read:roles"
+        # @see https://auth0.com/docs/api/management/v2#!/Roles/get_role_permission
+        #
+        # @param role_id [string] Role ID to add permissions.
+        # @param options [hash] A hash of options for getting permissions
+        #   - per_page: Number or permissions to return.
+        #   - page: Page number to return, zero-based
+        #   - include_totals: True to include query summary in the result, false or nil otherwise.
+        #
+        # @return [json] All permissions matching the query.
+        def get_role_permissions(role_id, options = {})
+          raise Auth0::MissingParameter, 'Must supply a valid role_id' if role_id.to_s.empty?
+
+          request_params = {
+            per_page: options.fetch(:per_page, nil),
+            page: options.fetch(:page, nil),
+            include_totals: options.fetch(:include_totals, nil)
+          }
+          get "#{roles_path}/#{role_id}/permissions", request_params
+        end
+
+        # Associate permissions with a Role.
+        # Required scope: "update:roles"
+        # @see https://auth0.com/docs/api/management/v2#!/Roles/post_role_permission_assignment
+        #
+        # @param role_id [string] Role ID to add permissions.
+        # @param permissions [array] Array of Permission structs to add.
+        def add_role_permissions(role_id, permissions)
+          raise Auth0::MissingParameter, 'Must supply a valid role_id' if role_id.to_s.empty?
+
+          permissions = validate_permissions_array(permissions)
+          post "#{roles_path}/#{role_id}/permissions", permissions: permissions
+        end
+
+        # Remove permissions from a Role.
+        # Required scope: "update:roles"
+        # @see https://auth0.com/docs/api/management/v2#!/Roles/delete_role_permission_assignment
+        #
+        # @param role_id [string] Role ID to remove permissions.
+        # @param permissions [array] Array of Permission structs to remove.
+        def remove_role_permissions(role_id, permissions)
+          raise Auth0::MissingParameter, 'Must supply a valid role_id' if role_id.to_s.empty?
+
+          permissions = validate_permissions_array(permissions)
+          delete_with_body("#{roles_path}/#{role_id}/permissions", permissions: permissions)
+        end
+
+        private
+
+        # Roles base API path
+        def roles_path
+          @roles_path ||= '/api/v2/roles'
+        end
+      end
+    end
+  end
+end

data/lib/auth0/api/v2/rules.rb

@@ -14,14 +14,18 @@ module Auth0
         # @param fields [string] A comma separated list of fields to include or exclude from the result.
         # @param include_fields [boolean] True if the fields specified are to be included in the result, false otherwise.
         # @param stage [string] Retrieves rules that match the execution stage (defaults to login_success).
+        # @param page [int] Page number to get, 0-based.
+        # @param per_page [int] Results per page if also passing a page number.
         #
         # @return [json] Returns the existing rules.
-        def rules(enabled: nil, fields: nil, include_fields: nil, stage: nil)
+        def rules(enabled: nil, fields: nil, include_fields: nil, stage: nil, page: nil, per_page: nil)
           request_params = {
             enabled:          enabled,
             fields:           fields,
             include_fields:   include_fields,
-            stage:            stage
+            stage:            stage,
+            page:             page,
+            per_page:         per_page
           }
           get(rules_path, request_params)
         end