---
title: "Overwrites a badge icon with a new one."
method: POST
path: "/v1/badges/{badgeId}/icon"
tags: ["Assets", "Thumbnails"]
---

# Overwrites a badge icon with a new one.

`POST /v1/badges/{badgeId}/icon`

## Path parameters

- `badgeId` integer, required

## Response `200`

OK

- RobloxBadgesApiIconUploadResponse — Badge icon upload response.
  - `targetId` integer — The asset id of the uploaded icon.

## Other responses

- `400` — 6: Text moderated. 22: Icon file is not present in the request.
- `401` — 0: Authorization has been denied for this request.
- `403` — 0: Token Validation Failed 2: You do not have permission to manage this badge.
- `404` — 1: Badge is invalid or does not exist.
- `429` — 13: Too many requests, try again later.

---

[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/9e4acc812347/schema)