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

# Updates the contents of an outfit.

`PATCH /v4/outfits/{outfitId}`

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

## Path parameters

- `outfitId` string, required

## Headers

- `Roblox-Place-Id` integer

## Request body

- RobloxApiAvatarModelsV4RequestUpdateOutfitDefinitionRequestV4 — Request model for updating an outfit (V4).
  - `updateTypes` integer[] — The list of data needed to be updated.
  - `outfitDefinition` RobloxApiAvatarModelsV4UpdateOutfitDefinition — A model containing outfit fields to create or update.
    - `updateOutfitModel` RobloxApiAvatarModelsV4UpdateOutfitModelV4 — A model containing core outfit fields to update.
      - `name` string — The outfit name.
      - `bodyColors` RobloxApiAvatarModelsBodyColorsModelV4 — A model containing RGB hex colors for each body part.
        - `headColor` string — The RGB hex color for head color, e.g. #FFFFFF
        - `torsoColor` string — The RGB hex color for torso color, e.g. #FFFFFF
        - `rightArmColor` string — The RGB hex color for right arm color, e.g. #FFFFFF
        - `leftArmColor` string — The RGB hex color for left arm color, e.g. #FFFFFF
        - `rightLegColor` string — The RGB hex color for right leg color, e.g. #FFFFFF
        - `leftLegColor` string — The RGB hex color for left leg color, e.g. #FFFFFF
      - `assets` RobloxApiAvatarModelsAssetWearModel[] — The assets on the outfit.
        - `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` 1 | 3 — The player avatar type.
      - `outfitType` 0 | 1 | 2 | 4 | 5 — The type of outfit (for example Avatar or Makeup). Defaults to Avatar when omitted.
    - `updateOutfitConfig` RobloxApiAvatarModelsV4UpdateOutfitConfig — A model containing outfit config fields to update.
      - `backgroundRequestModel` RobloxApiAvatarModelsV4AvatarBackgroundRequestModel — A model which contains the asset id of the background. This can be extended to have more attributes in the future.
        - `id` integer — An asset id.

## Response `200`

OK

- RobloxApiAvatarModelsV4ResponseUpdateOutfitDefinitionResponseV4 — Response model for update outfit (V4).
  - `success` boolean — Whether all requested changes were successfully applied.
  - `validation` RobloxApiAvatarModelsV4ResponseOutfitValidationResultV4 — Validation details for outfit mutation responses when one or more inputs could not be applied.
    - `unwornAssets` RobloxApiAvatarModelsAssetModelV2[] — Assets that could not be worn.
      - `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.
    - `invalidBackground` RobloxApiAvatarModelsInvalidBackgroundResponse[] — Background assets that could not be applied.
      - `BackgroundAssetId` integer — The asset id of the emote
      - `Error` string — The error associated with the background.

## 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/revisions/958b2b40425d/schema)