---
title: "Updates the contents of an outfit."
method: PATCH
path: "/v3/outfits/{userOutfitId}"
tags: ["Avatars"]
---

# Updates the contents of an outfit.

`PATCH /v3/outfits/{userOutfitId}`

Fails if the user does not own any of the assetIds or if they are not wearable asset types.
Accepts partial updates.

## Path parameters

- `userOutfitId` integer, required

## Headers

- `Roblox-Place-Id` integer

## Request body

- RobloxApiAvatarModelsOutfitUpdateModelV3 — A model containing details needed to update or create an outfit.
  - `name` string — The outfit name.
  - `bodyColor3s` RobloxApiAvatarModelsBodyColors3Model — A model containing RGB hex colors for each body part.
    - `headColor3` string — The RGB hex color for head color, e.g. #FFFFFF
    - `torsoColor3` string — The RGB hex color for torso color, e.g. #FFFFFF
    - `rightArmColor3` string — The RGB hex color for right arm color, e.g. #FFFFFF
    - `leftArmColor3` string — The RGB hex color for left arm color, e.g. #FFFFFF
    - `rightLegColor3` string — The RGB hex color for right leg color, e.g. #FFFFFF
    - `leftLegColor3` string — The RGB hex color for left leg color, e.g. #FFFFFF
  - `assets` RobloxApiAvatarModelsAssetWearModel[] — Array of assets.
    - `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
  - `scale` RobloxWebResponsesAvatarScaleModel
    - `height` number, double
    - `width` number, double
    - `head` number, double
    - `depth` number, double
    - `proportion` number, double
    - `bodyType` number, double
  - `playerAvatarType` string — The avatar scale.
  - `outfitType` 0 | 1 | 2 | 4 | 5 — The type of outfit.

## Response `200`

OK

- RobloxApiAvatarModelsOutfitModel — A slim model for user outfits.
  - `id` integer — The id.
  - `name` string — The name.
  - `isEditable` boolean — Whether the outfit can be modified by the user.
  - `outfitType` string — The type of the Outfit.

## Other responses

- `400` — 3: Body colors must be valid BrickColor IDs 4: Invalid outfit name 5: Asset is not wearable by you 8: Invalid Player Avatar Type. Valid types are R6 and R15 11: Meta does not apply to specified asset type 12: Meta is required for this specific asset type 13: Invalid Outfit Type 14: Invalid scale
- `401` — 0: Authorization has been denied for this request.
- `403` — 0: Token Validation Failed 2: You don't have permission to update this outfit.
- `404` — 1: The specified userOutfit does not exist!
- `500` — 6: An error occurred while trying to update the outfit

---

[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)