Create a new user. Only avaialble to admin user.

v1.0.0

Input

{
  "type": "object",
  "description": "An account to create/add to the system. If already exists will return 400.",
  "required": [
    "name"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "An optional email to associate with the account for contact purposes"
    },
    "name": {
      "type": "string",
      "description": "The account name to use. This will identify the account and must be globally unique in the system."
    }
  }
}

Output

{
  "type": "object",
  "description": "Account information",
  "required": [
    "name"
  ],
  "properties": {
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "The timestamp when the account was created"
    },
    "email": {
      "type": "string",
      "description": "Optional email address associated with the account"
    },
    "last_updated": {
      "type": "string",
      "format": "date-time",
      "description": "The timestamp of the last update to the account metadata itself (not users or creds)"
    },
    "name": {
      "type": "string",
      "description": "The account identifier, not updatable after creation"
    },
    "state": {
      "type": "string",
      "description": "State of the account. Disabled accounts prevent member users from logging in, deleting accounts are disabled and pending deletion and will be removed once all owned resources are garbage collected by the system",
      "enum": [
        "enabled",
        "disabled",
        "deleting"
      ]
    },
    "type": {
      "type": "string",
      "description": "The user type (admin vs user). If not specified in a POST request, 'user' is default",
      "enum": [
        "user",
        "admin",
        "service"
      ]
    }
  }
}