Change the username, username aliases, full name, status, and/or notes section of the user with ID user_id.

Requires “Grant write resource” API permission.

​
Basic Parameters

ParameterDescription
EmailThe email address of this user.
User IDUser ID to modify.
UsernameThe new username.

​
Advanced Parameters

ParameterDescription
First NameThe user’s given name.
Last NameThe user’s surname.
NotesAn optional description or notes field. Can be viewed in the Duo Admin Panel.
Real NameThe real name (or full name) of this user.
StatusThe user’s status. One of:- “active” The user must complete secondary authentication. This is the default value if no status is specified.- “bypass” The user will bypass secondary authentication after completing primary authentication.- “disabled” The user will not be able to complete secondary authentication.

​
Example Output

{
  "stat": "OK",
  "response": {
    "alias1": "joe.smith",
    "alias2": "jsmith@example.com",
    "alias3": null,
    "alias4": null,
    "aliases": {
      "alias1": "joe.smith",
      "alias2": "jsmith@example.com"
    },
    "created": 1489612729,
    "email": "jsmith@example.com",
    "firstname": "Joe",
    "groups": [
      {
      "desc": "People with hardware tokens",
      "group_id": "DGXXXXXXXXXXXXXXXXX",
      "mobile_otp_enabled": false,
      "name": "token_users",
      "push_enabled": false,
      "sms_enabled": false,
      "status": "Active",
      "voice_enabled": false  
      }
    ],
    "is_enrolled": true,
    "last_directory_sync": 1508789163,
    "last_login": 1343921403,
    "lastname": "Smith",
    "notes": "",
    "phones": [
      {
      "activated": true,
      "capabilities": [
        "auto",
        "push",
        "sms",
        "phone",
        "mobile_otp"
        ],
      "encrypted": "Encrypted",
      "extension": "",
      "fingerprint": "Configured",
      "last_seen": "2019-11-18T15:51:13",
      "model": "Apple iPhone 11 Pro",
      "name": "My iPhone",
      "number": "15555550100",
      "phone_id": "DPFZRS9FB0D46QFTM899",
      "platform": "Apple iOS",
      "postdelay": "0",
      "predelay": "0",
      "screenlock": "Locked",
      "sms_passcodes_sent": true,
      "tampered": "Not tampered",
      "type": "Mobile"
      }
    ],
    "realname": "Joe Smith",
    "status": "active",
    "tokens": [
      {
      "serial": "123456",
      "token_id": "DHIZ34ALBA2445ND4AI2",
      "type": "d1"
      }
    ],
    "u2ftokens": [],
    "user_id": "DU3RP9I2WOC59VZX672N",
    "username": "jsmith",
    "webauthncredentials": [
      {
      "credential_name": "Touch ID",
      "date_added": 1550685154,
      "label": "Touch ID",
      "webauthnkey": "WABFEOE007ZMV1QAZTRB"
      },
      {
      "credential_name": "YubiKey C",
      "date_added": 1550674764,
      "label": "Security Key",
      "webauthnkey": "WA4BD9AUVMSNUFWZGES4"
      }
    ],
  }
}

​
Workflow Library Example

Edit User with Duo and Send Results Via Email

Preview this Workflow on desktop

Was this page helpful?

Edit PhoneEnroll User