Modify Users

Modifies user properties directly. User resources: exceptions, preferences, and ssh keys can be added, modified or removed. "UID" and "Type" are immutable once created.

Example Request:

PUT /api/user/v1/users/joe HTTP/1.1
Authorization: Basic abcefgMWE=
Host: zfssa.example.com:215
Accept: application/json
Content-Type: application/json
Content-Length: 24

{"require_annotation": true}

Example Result:

HTTP/1.1 202 Accepted
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 236

{
    "user": {
        "href": "/api/user/v1/users/john",
        "logname": "john",
        "type": "local",
        "uid": 2000000000,
        "fullname": "John Doe",
        "initial_password": "DummyPassword",
        "require_annotation": true,
        "kiosk_mode": false,
        "kiosk_screen": "status/dashboard",
        "roles": ["basic"]
    }
}