AWaws-samples
User Management

Create new user

Changed on

Create a new LDAP user with home directory, SSH keys, and group membership

post/api/ldap/user

Request

  • The document declares no server URL.
  • Auth
    socaAuth (a scheme the document does not define) and socaToken (a scheme the document does not define)

Request body application/x-www-form-urlencoded

userstring required

Username for the new user (alphanumeric, _, -, . allowed, max 31 chars)

passwordstring password required

Password for the new user

sudoers0 | 1 required

Grant sudo permissions (1 = yes, 0 = no)

emailstring email required

Email address for the user

shellstring

Login shell for the user

uidinteger

Linux UID (0 = auto-assign)

gidinteger

Linux GID (0 = auto-assign)

Example request

{
  "user": "john.doe",
  "password": "SecurePass123!",
  "email": "john.doe@company.com",
  "shell": "/bin/bash",
  "uid": 1001,
  "gid": 1001
}

Response

User created successfully

successboolean
messagestring

Example response

{
  "success": true,
  "message": "User created"
}

Changes

  • v1058396b8f0f1Revision changes
    • info

      the endpoint scheme security socaAuth AND socaToken was added to the API

    • info

      the endpoint scheme security edhAuth AND edhToken was removed from the API

  • v16db97cead8dfRevision changes
    • info

      the endpoint scheme security edhAuth AND edhToken was added to the API

    • info

      the endpoint scheme security socaAuth AND socaToken was removed from the API