json_schema: {
    "$schema": "http://json-schema.org/draft-04/schema#",
    "properties": {
      "user_information": {
        "description": "The Chef user (or in the case of unlinked user, the default information about the Chef user from LDAP or AD)",
        "type": "object",
        "properties": {
          "username": {
            "description": "A unique namespace matching the format [a-z0-9\\-_]+",
            "type": "string"
          },
          "display_name": {
            "description": "Human-readable name to be rendered into UIs and other human-readable locations",
            "type": "string"
          },
          "email": {
            "description": "Valid email address for the new user",
            "type": "string"
          },
          "first_name": {
            "description": "The first name of the new user",
            "type": "string"
          },
          "middle_name": {
            "description": "The middle name of the new user",
            "type": "string"
          },
          "last_name": {
            "description": "The last name of the new user",
            "type": "string"
          },
          "external_authentication_uid": {
            "description": "The external authentication UID of the user (their AD or LDAP ID, generally)",
            "type": "boolean"
          },
          "recovery_authentication_enabled": {
            "description": "Whether this user may log in with their password from the system_recovery endpoint when AD is down",
            "type": "boolean",
            "default": false
          }
        },
        "required" : ["username","display_name","email"]
      }
    },
    "example": {
      "user": "user1",
      "display_name": "Real Name",
      "email": "user1@chef.example",
      "password": "guest",
      "create_key": true,
      "external_authentication_uid": "jkeiser",
      "system_recovery_enabled": false
    }
  }
  