Adding a hat to the avatar removes the entire outfit

Some hats, when added to the avatar, remove the current outfit the avatar is wearing. This would be a bad experience for the user. Why do some hats do this? Is there a way to warn the user if they are about to make a change that affects their previous changes?

Can you provide an example of the outfits and hats that behave like this?

Is there any documentation for /v2 API? I see that the web creator is making PATCH calls to update the user’s outfit and passing the asset ID in the request body. This is very different than the PUT calls here PUT - Equip an asset | Ready Player Me.

I’d like to use apiV2

You can find more info about it here:

I have another example…I changed my avatar’s bodyShape to heavyset. And then when I go to equip a shirt, it changes the bodyShape back to default… Why does equipping assets do this? Here is the request that reset the bodyShape:

PUT /v1/avatars/66bd6cda79bf32ac3f74710e/equip HTTP/1.1
{"data":{"assetId":"146120230"}}