Update User

Usage Notes

Operations

The following patch operations(op) are supported for the SCIM PATCH calls.

• Add - Use this operation to add a new value for the attribute.
• Replace - Use this operation to replace existing value of an attribute and or to re-enable a disabled user.
  • When updating accountIndicators, licenses and persona collection properties, the replace operation is going to replace the entire collection, replacement of individual collection records and sub-attributes is not supported.
    • For example, if you have two personas associated, and you only include one in the PATCH replace call, the two get replaced with the one.
    • If only one of the two personas associated needs to be replaced, the request payload must include the details for both records (existing record to be retained and a new record to be added.
• Remove - Delete the existing value of an attribute specified in the path.
  • The "value" attribute is not applicable to the "remove" operation.
  • The "path" attribute is required for remove operation.
  • The filter details of what is to be removed must be sent as part of the path attribute.

Updating State License Information

• When adding a new State license via PATCH with “add” operation, the “selected” attribute must be set to “true”, in order for the state license information to be added.
• When updating the State license information, the best practice is also to use the “add” operation. Send only the attributes that need to be updated. You do not need to resend all attributes for the license object.
  • Known Issue: In the current version of this API you must send all attributes including the attributes that need to be updated. This will be resolved in a future release.
• To indicate that a State license is no longer active, and retain all other information about that State license, use the “add” operation. Only send the “selected” attribute in the request, and set it to “false”. This will deactivate the license, but preserve all other data about that State license.
  • Known Issue: In the current version of this API you must send all attributes (existing license information) including the selected property being set to false. This will be resolved in a future release.
• To completely remove all evidence of a State license, use the “replace” operation. Replace will completely clear out all field values for that State license record, as if it never existed. The only required attribute to completely remove evidence of a State license is the “stateAbbrevation” for the State license you want to remove, and it must be set to the two-digit State Postal Code, e.g. "WA" for Washington State.
• The “remove” operation cannot be used to update a license.

Updating an Attribute

• The path in the PATCH request body is used to specify the attribute/sub-attribute that should be updated.
  Example: "path": "urn:ietf:params:scim:schemas:extension:ice:2.0:EncompassInternalUser:name.middleName"
• Path is an optional parameter for add and replace operations, there are two ways to define the operation in a payload: with or without the path parameter.
• Although the path is not mandatory for add and replace operations, the path is supported for all operations.