#  SPDX-License-Identifier: Apache-2.0
force_logout:
  # Description of the service
  description: Force logout of Alexa Login account and deletion of .pickle. Intended for debugging use.
  # Different fields that your service accepts
  fields:
    # Key of the field
    email:
      # Description of the field
      description: List of Alexa accounts to log out. If empty, will log out from all known accounts.
      # Example value that can be passed for this field
      example: "my_email@alexa.com"

restore_volume:
  description: Restores an Alexa Media Player volume level to the previous volume level.
  fields:
    entity_id:
      name: Entity
      description: Alexa Media Player device to restore volume on.
      required: true
      selector:
        entity:
          domain: media_player
          integration: alexa_media

get_history_records:
  description: Returns the last entries of all the customer history.
  fields:
    entity_id:
      name: Entity
      description: Alexa Media Player device to get history from.
      required: true
      selector:
        entity:
          domain: media_player
          integration: alexa_media
    entries:
      name: Entries
      description: Number of records to return.
      required: false
      default: 5
      example: 5

update_last_called:
  # Description of the service
  description: Forces update of last_called echo device for each Alexa account.
  # Different fields that your service accepts
  fields:
    # Key of the field
    email:
      # Description of the field
      description: List of Alexa accounts to update. If empty, will update all known accounts.
      # Example value that can be passed for this field
      example: "my_email@alexa.com"

enable_network_discovery:
  name: Enable network discovery
  description: >
    Re-enable Alexa network discovery so the next polling cycle will
    rediscover Alexa devices for the selected accounts.
  fields:
    email:
      name: Account email(s)
      description: >
        Optional Alexa account email or list of emails. If omitted,
        all Alexa Media accounts will be refreshed.
      required: false
      example: [email protected]
      selector:
        text: