Method: Auth0::Api::V2::DeviceCredentials#device_credentials

Defined in:
lib/auth0/api/v2/device_credentials.rb

#device_credentials(client_id = nil, options = {}) ⇒ json Also known as: list_device_credentials

Retrieves log entries that match the specified search criteria. rubocop:disable Metrics/AbcSize

Parameters:

  • client_id (string) (defaults to: nil) —

    The client_id of the devices to retrieve.

  • options (hash) (defaults to: {}) —

    • :fields [string] A comma separated list of fields to include or exclude from the result.

    • :include_fields [boolean] True if the fields specified are to be included in the result, false otherwise.

    • :user_id [string] The user_id of the devices to retrieve.

    • :type [string] Type of credentials to retrieve. Must be ‘public_key’, ‘refresh_token’ or ‘rotating_refresh_token’

    • :page [integer] The page number. Zero based

    • :per_page [integer] The amount of entries per page

    • :include_totals [boolean] Return results inside an object that contains the total result count (true) or as a direct array of results (false, default).

Returns:

  • (json) —

    Returns the list of existing devices for the specified client_id.

See Also:



22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
 
# File 'lib/auth0/api/v2/device_credentials.rb', line 22

def device_credentials(client_id = nil, options = {})
  request_params = {
    fields: options.fetch(:fields, nil),
    include_fields: options.fetch(:include_fields, nil),
    user_id: options.fetch(:user_id, nil),
    client_id: client_id,
    type: options.fetch(:type, nil),
    page: options.fetch(:page, nil),
    per_page: options.fetch(:per_page, nil),
    include_totals: options.fetch(:include_totals, nil)
  }
  if !request_params[:type].nil? && !%w(public_key refresh_token rotating_refresh_token).include?(request_params[:type])
    raise Auth0::InvalidParameter, 'Type must be one of \'public_key\', \'refresh_token\', \'rotating_refresh_token\''
  end
  get(device_credentials_path, request_params)
end