---
title: "PUT /components/v1/asset/{name}"
method: PUT
path: "/components/v1/asset/{name}"
tags: ["Assets"]
---

# PUT /components/v1/asset/{name}

`PUT /components/v1/asset/{name}`

Updates an asset in the Assets Library.

## Request body

- AssetUpdate
  - `type` 'product' | 'badge' | 'bgMobile' | 'bgDesk' | 'logo' | 'favicon' | 'bgBundle' | 'bgPopup' | 'general' | 'section' | 'productPrefix' | 'playerLevel' | 'banner' | 'addToHomeButtonImage' | 'addToHomeIconImage' | 'playerProfileImage' | 'offerHeader' | 'backToGameButtonImage' | 'animation' | 'trait' — Asset category.
  - `name` string — Asset name.
  - `file` string, binary — A valid PNG or JPEG image file. Maximum size is 2 MB.
  - `externalImageUrl` string, url — URL to a valid, publicly accessible image. Appcharge saves and uses this URL as-is and doesn't download, copy, upload, or host the image on Appcharge CDN. The image must remain available at the provided URL. We recommend uploading image files instead of using external URLs when possible. Appcharge hosts uploaded files on its CDN. Maximum size is 2 MB. Must be in PNG or JPEG format.

## Response `200`

Asset updated successfully.

- AssetResponse
  - `id` string — Asset ID.
  - `name` string — Asset name.
  - `type` 'product' | 'badge' | 'bgMobile' | 'bgDesk' | 'logo' | 'favicon' | 'bgBundle' | 'bgPopup' | 'general' | 'section' | 'productPrefix' | 'playerLevel' | 'banner' | 'addToHomeButtonImage' | 'addToHomeIconImage' | 'playerProfileImage' | 'offerHeader' | 'backToGameButtonImage' | 'animation' | 'trait' — Asset category.
  - `imageUrl` string, url — Image URL. For uploaded files, this is the Appcharge-hosted CDN URL. For external image URLs, this is the original image URL served from your CDN at the provided URL.
  - `contentType` string — Image [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/MIME_types).
  - `externalImageUrl` string, url — Original image URL if the asset uses an external image URL. This URL is served from your CDN at the provided URL.

## Other responses

- `400` — Bad request. Invalid input or validation failure.
- `404` — Asset not found.

---

[API](https://skmtc.net/appcharge/apis/grant-award.md) · [All operations](https://skmtc.net/appcharge/apis/grant-award/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/appcharge/grant-award/revisions/b4f6759240d5/schema)