---
title: "Sets the avatar's current assets to the list."
method: POST
path: "/v2/avatar/set-wearing-assets"
tags: ["Avatars"]
---

# Sets the avatar's current assets to the list.

`POST /v2/avatar/set-wearing-assets`

Only allows items that you own, are not expired, and are wearable asset types.
Any assets being worn before this method is called are automatically removed.

## Headers

- `Roblox-Place-Id` integer

## Request body

- RobloxApiAvatarModelsWearRequestModel — A model that contains a list of AssetWear models
  - `assets` RobloxApiAvatarModelsAssetWearModel[] — The asset ids
    - `id` integer — An asset id
    - `meta` RobloxApiAvatarModelsAssetMetaModelV1 — Exhaustive model denoting all possible metadata fields of an asset
      - `order` integer — Layered-clothing order
      - `puffiness` number, float — Layered-clothing puffiness
      - `position` RobloxApiAvatarModelsAssetPosition — A model which contains accessory position coordinates.
        - `X` number, float — X coordinate of the position.
        - `Y` number, float — y coordinate of the position.
        - `Z` number, float — Z coordinate of the position.
      - `rotation` RobloxApiAvatarModelsAssetRotation — A model which contains accessory rotation coordinates.
        - `X` number, float — X degrees of the rotation.
        - `Y` number, float — Y degrees of the rotation.
        - `Z` number, float — Z degrees of the rotation.
      - `scale` RobloxApiAvatarModelsAssetScale — A model which contains accessory scale.
        - `X` number, float — X scale multiplier of accessory.
        - `Y` number, float — Y scale multiplier of accessory.
        - `Z` number, float — Z scale multiplier of accessory.
      - `headShape` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 — Head Shape selected for the asset id. Applicable for dynamic head assets.
      - `staticFacialAnimation` boolean — Indicates user choice for facial animation. staticFacialAnimation=false, implies the toggle as on and face will animate. Applicable for dynamic head assets.
      - `version` integer — Client-authoritative meta model format version - default is always 1

## Response `200`

OK

- RobloxApiAvatarModelsWearResponseModel — A model for wear outfit responses
  - `invalidAssets` RobloxApiAvatarModelsAssetModelV2[] — The assets that could not be worn Unlike invalidAssetIds, only contains assets that are wearable types
    - `id` integer — The id
    - `name` string — The name
    - `assetType` RobloxApiAvatarModelsAssetTypeModel — A model containing details about an asset type
      - `id` integer — The id
      - `name` string — The name
    - `currentVersionId` integer — Id of the current version of asset
    - `meta` RobloxApiAvatarModelsAssetMetaModelV1 — Exhaustive model denoting all possible metadata fields of an asset
      - `order` integer — Layered-clothing order
      - `puffiness` number, float — Layered-clothing puffiness
      - `position` RobloxApiAvatarModelsAssetPosition — A model which contains accessory position coordinates.
        - `X` number, float — X coordinate of the position.
        - `Y` number, float — y coordinate of the position.
        - `Z` number, float — Z coordinate of the position.
      - `rotation` RobloxApiAvatarModelsAssetRotation — A model which contains accessory rotation coordinates.
        - `X` number, float — X degrees of the rotation.
        - `Y` number, float — Y degrees of the rotation.
        - `Z` number, float — Z degrees of the rotation.
      - `scale` RobloxApiAvatarModelsAssetScale — A model which contains accessory scale.
        - `X` number, float — X scale multiplier of accessory.
        - `Y` number, float — Y scale multiplier of accessory.
        - `Z` number, float — Z scale multiplier of accessory.
      - `headShape` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 — Head Shape selected for the asset id. Applicable for dynamic head assets.
      - `staticFacialAnimation` boolean — Indicates user choice for facial animation. staticFacialAnimation=false, implies the toggle as on and face will animate. Applicable for dynamic head assets.
      - `version` integer — Client-authoritative meta model format version - default is always 1
    - `availabilityStatus` string — Asset availability status.
    - `expirationTime` string, date-time — For rental assets only. (Future) ownership expiration time of the asset.
    - `supportsHeadShapes` boolean — If the "Id" is swappable, applicable for DH assets.
  - `invalidAssetIds` integer[] — The asset ids that could not be worn
  - `success` boolean — Whether or not all the outfit contents were successfully worn

## Other responses

- `400` — 3: Invalid assetId 5: Meta does not apply to specified asset type 7: Required meta is not provided for the specific asset type
- `401` — 0: Authorization has been denied for this request.
- `403` — 0: Token Validation Failed
- `500` — 2: Failed to wear asset.

---

[API](https://skmtc.net/roblox/apis/roblox-api.md) · [All operations](https://skmtc.net/roblox/apis/roblox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/roblox/roblox-api/versions/e15802062270/schema)