---
title: "Update Asset"
method: PATCH
path: "/assets/{assetId}"
tags: ["asset"]
---

# Update Asset

`PATCH /assets/{assetId}`

Use this endpoint to update an asset

## Path parameters

- `assetId` string, required

## Request body

- UpdateAssetRequest
  - `data` object
    - `name` string — The name of the asset
    - `type` 'outfit' | 'top' | 'shirt' | 'bottom' | 'beard' | 'eye' | 'eyebrows' | 'eyeshape' | 'facemask' | 'faceshape' | 'facewear' | 'footwear' | 'glasses' | 'hair' | 'headwear' | 'lipshape' | 'noseshape' | 'costume' — Defines which body part of the avatar this asset belongs to
    - `gender` 'male' | 'female' | 'neutral' — Defines which avatar genders are supported
    - `modelUrl` string, url — Must be a valid url pointing to a GLB file
    - `iconUrl` string, url — Must be a valid url pointing to a PNG or JPG file
    - `locked` boolean — Whether the asset is locked
    - `applications` ApplicationAssetRelation[] — List of application-asset relations this asset should be available in
      - `id` string — Id of the application
      - `organizationId` string — Application owner organization ID
      - `isVisibleInEditor` boolean — Boolean which defines if the asset is visible in provided applications avatar editor
      - `masculineOrder` integer — For male/neutral assets, defines the asset order in avatar editor for specified application
      - `feminineOrder` integer — For female/neutral assets, defines the asset order in avatar editor for specified application

## Response `201`

A typical successful response

- AssetInfoResponse
  - `data` AssetInfo
    - `id` string — Automatically generated numeric Identifier of an asset
    - `name` string — The name of an asset
    - `organizationId` string — The Id of the asset owner organization
    - `locked` boolean — A boolean value which when set to true requires the asset to be unlocked for specific user before it is usable by them
    - `type` 'outfit' | 'top' | 'shirt' | 'bottom' | 'beard' | 'eye' | 'eyebrows' | 'eyeshape' | 'facemask' | 'faceshape' | 'facewear' | 'footwear' | 'glasses' | 'hair' | 'headwear' | 'lipshape' | 'noseshape' | 'costume' — Defines which body part of the avatar this asset belongs to
    - `gender` 'male' | 'female' | 'neutral' — Defines which avatar genders are supported
    - `modelUrl` string — The URL where you can find the GLB model for the asset
    - `iconUrl` string — The URL where you can find the icon for the asset
    - `hasApps` boolean — A boolean value indicating if this asset is available in any applications or not
    - `createdAt` string, date-time — Datetime when this asset was created
    - `updatedAt` string, date-time — Datetime when this asset was last updated
    - `applications` ApplicationAssetRelation[] — Array of application-asset relations
      - `id` string — Id of the application
      - `organizationId` string — Application owner organization ID
      - `isVisibleInEditor` boolean — Boolean which defines if the asset is visible in provided applications avatar editor
      - `masculineOrder` integer — For male/neutral assets, defines the asset order in avatar editor for specified application
      - `feminineOrder` integer — For female/neutral assets, defines the asset order in avatar editor for specified application

## Changes

- **2026-01-21** `7ca69abee81f` — 17 info
  - added the new `beard` enum value to the request property `data/type`
  - added the new `bottom` enum value to the request property `data/type`
  - added the new `costume` enum value to the request property `data/type`
  - added the new `eye` enum value to the request property `data/type`
  - …13 more
- **2025-03-18** `6d708f9e1842` — 17 breaking
  - removed the enum value `beard` of the request property `data/type`
  - removed the enum value `bottom` of the request property `data/type`
  - removed the enum value `costume` of the request property `data/type`
  - removed the enum value `eye` of the request property `data/type`
  - …13 more

[Change history](https://skmtc.dev/zerobias-org/apis/zerobias-org-module-readyplayerme-readyplayerme/changes/assets/:assetId/patch.md)

---

[API](https://skmtc.dev/zerobias-org/apis/zerobias-org-module-readyplayerme-readyplayerme.md) · [All operations](https://skmtc.dev/zerobias-org/apis/zerobias-org-module-readyplayerme-readyplayerme/llms.txt) · [OpenAPI document](https://skmtc.dev/zerobias-org/apis/zerobias-org-module-readyplayerme-readyplayerme/revisions/34213152576e?raw)