Endpoint

/v1/users/

GET

List all users in the local user database. Refer to the 'Modify user' method for a description of the returned fields.

Parameters

This resource has no parameters.

Response

Codes

Code Description
200 Return value on success

Schema

{
  "type": "array",
  "items": {
    "description": "api_user",
    "type": "object",
    "properties": {
      "id": {
        "description": "The user's unique id",
        "type": "string"
      },
      "name": {
        "description": "The user's account name",
        "type": "string"
      },
      "primary_group": {
        "description": "The unique ID of the user's group",
        "type": "string"
      },
      "sid": {
        "description": "The users's SID",
        "type": "string"
      },
      "uid": {
        "description": "The user's NFS uid",
        "type": "string"
      },
      "home_directory": {
        "description": "The path to the user's home directory",
        "type": "string"
      },
      "can_change_password": {
        "description": "Specifies whether the user can change the password",
        "type": "boolean"
      }
    }
  }
}

POST

Add a user.

Parameters

This resource has no parameters.

Request

Schema

{
  "description": "api_user_post",
  "type": "object",
  "properties": {
    "name": {
      "description": "The user's account name",
      "type": "string"
    },
    "primary_group": {
      "description": "The unique ID of the user's group",
      "type": "string"
    },
    "uid": {
      "description": "The user's NFS uid",
      "type": "string"
    },
    "home_directory": {
      "description": "The user's home directory path",
      "type": "string"
    },
    "password": {
      "description": "The user's password",
      "type": "string",
      "format": "password"
    }
  }
}

Response

Codes

Code Description
200 Return value on success

Schema

{
  "description": "api_user",
  "type": "object",
  "properties": {
    "id": {
      "description": "The user's unique id",
      "type": "string"
    },
    "name": {
      "description": "The user's account name",
      "type": "string"
    },
    "primary_group": {
      "description": "The unique ID of the user's group",
      "type": "string"
    },
    "sid": {
      "description": "The users's SID",
      "type": "string"
    },
    "uid": {
      "description": "The user's NFS uid",
      "type": "string"
    },
    "home_directory": {
      "description": "The path to the user's home directory",
      "type": "string"
    },
    "can_change_password": {
      "description": "Specifies whether the user can change the password",
      "type": "boolean"
    }
  }
}