action files_history_list_logins {
  label: "List site login history."
  description: "List site login history."
  provider: files
  method: GET
  path: "/history/login"
  encoding: json
  input: {
    type: "object"
    properties: {
      cursor: {
        type: "string"
      }
      display: {
        type: "string"
      }
      end_at: {
        type: "string"
        format: "date-time"
      }
      per_page: {
        type: "integer"
        format: "int32"
      }
      sort_by: {
        type: "object"
      }
      start_at: {
        type: "string"
        format: "date-time"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "array"
    items: {
      type: "object"
      description: "List site full action history."
      properties: {
        action: {
          type: "string"
          description: "Type of action"
          enum: ["create", "read", "update", "destroy", "move", "login", "failedlogin", "copy", "user_create", "user_update", "user_destroy", "group_create", "group_update", "group_destroy", "permission_create", "permission_destroy", "api_key_create", "api_key_update", "api_key_destroy"]
        }
        destination: {
          type: "string"
          description: "The destination path for this action, if applicable"
        }
        display: {
          type: "string"
          description: "Friendly displayed output"
        }
        failure_type: {
          type: "string"
          description: "Failure type.  If action was a user login or session failure, why did it fail?"
          enum: ["expired_trial", "account_overdue", "locked_out", "ip_mismatch", "password_mismatch", "site_mismatch", "username_not_found", "none", "no_ftp_permission", "no_web_permission", "no_directory", "errno_enoent", "no_sftp_permission", "no_dav_permission", "no_restapi_permission", "key_mismatch", "region_mismatch", "expired_access", "desktop_ip_mismatch", "desktop_api_key_not_used_quickly_enough", "disabled", "country_mismatch"]
        }
        id: {
          type: "integer"
          format: "int32"
          description: "Action ID"
        }
        interface: {
          type: "string"
          description: "Interface on which this action occurred."
          enum: ["web", "ftp", "robot", "jsapi", "webdesktopapi", "sftp", "dav", "desktop", "restapi", "scim", "office", "mobile", "as2", "inbound_email", "remote"]
        }
        ip: {
          type: "string"
          description: "IP Address that performed this action"
        }
        path: {
          type: "string"
          description: "Path"
        }
        source: {
          type: "string"
          description: "The source path for this action, if applicable"
        }
        targets: {
          type: "array"
          description: "Targets"
          items: {
            type: "object"
          }
        }
        user_id: {
          type: "integer"
          format: "int32"
          description: "User ID"
        }
        username: {
          type: "string"
          description: "Username"
        }
        when: {
          type: "string"
          format: "date-time"
          description: "Action occurrence date/time"
        }
      }
    }
  }
}