The PUT /directory/v1/{dn} endpoint functions like an LDAP moddn operation for moving or renaming one LDAP entry when the _dn attribute is included in the request. To change the DN of an entry, both the new DN and the naming attribute, the attribute used in the entry’s RDN (relative distinguished name), must be present in the specified entry, even if the naming attribute is not changing. This rename operation can be in the same request as other attributes are modified. However, an error from either the rename or the modify portions of the request causes the entire operation to fail.

Note: If an entry is renamed and modified in one request, a Multi-Update Request Extended Request (OID 1.3.6.1.4.1.30221.2.6.17) is used. The request can fail if no ACI is created to allow a user to use this request, even if the user has permission to perform modify and rename operations independently. The following sample shows a multi-update ACI:

(extop="1.3.6.1.4.1.30221.2.6.17")(version 3.0; acl "Grant access to the Multi Update Extended Request for the rest-api-client account"; allow (all) userdn="ldap:///uid=rest-api-client,o=example";)

You can use the PUT /directory/v1/{dn} operation to change the name associated with the specified entry from Linda Jones to Linda Smith.