---
title: "PUT /v1/admin/model-square/banners/{bannerId}"
method: PUT
path: "/v1/admin/model-square/banners/{bannerId}"
tags: ["AdminModelSquareService"]
---

# PUT /v1/admin/model-square/banners/{bannerId}

`PUT /v1/admin/model-square/banners/{bannerId}`

UpdateBanner 编辑 Banner（仅平台管理员）。
 UpdateBanner edits a banner (platform admin only).

## Path parameters

- `bannerId` integer, required

## Request body

- ModelsquareV1UpdateBannerRequest — UpdateBannerRequest 编辑 Banner 请求。/ UpdateBannerRequest edits a banner.
  - `bannerId` integer
  - `description` string — 推送描述，必填，最长 500 个字符。
  - `i18nImages` ModelsquareV1I18nImage[] — 中英文图片列表，必须同时包含 zh 和 en 两条。 zh + en image list; both languages are required.
    - `imageUrl` string — 当前语言 Banner 大图地址。/ Full-size banner image URL for this language.
    - `langCode` string — 语言编码：仅允许 zh / en。/ Language code: only zh or en.
    - `thumbnailUrl` string — 当前语言 Banner 缩略图地址（可选）。/ Thumbnail URL for this language (optional).
  - `jumpUrl` string
  - `remark` string
  - `sort` integer
  - `title` string — 推送标题，必填，最长 100 个字符。

## Response `200`

OK

- ModelsquareV1Banner — Banner 推介图配置。/ Banner is a promotion image configuration.
  - `bannerCode` string
  - `bannerId` integer
  - `createdAt` string, date-time
  - `creator` string
  - `creatorName` string — 创建人展示名；无法解析时回退 creator。
  - `description` string — 推送描述，最长 500 个字符。
  - `i18nImages` ModelsquareV1I18nImage[] — 中英双语图片全量。/ Full set of zh + en images.
    - `imageUrl` string — 当前语言 Banner 大图地址。/ Full-size banner image URL for this language.
    - `langCode` string — 语言编码：仅允许 zh / en。/ Language code: only zh or en.
    - `thumbnailUrl` string — 当前语言 Banner 缩略图地址（可选）。/ Thumbnail URL for this language (optional).
  - `imageUrl` string
  - `jumpUrl` string
  - `langCode` string — 按请求 lang 解析出的当前语言图片信息（列表接口填充；创建/编辑响应可为空）。 Resolved current-language image by request lang (filled by list; may be empty on create/update).
  - `remark` string
  - `sort` integer
  - `status` string — 推荐状态：PENDING(待发布) / PUBLISHED(已发布) / OFFLINE(已下架)。 Status: PENDING / PUBLISHED / OFFLINE.
  - `thumbnailUrl` string
  - `title` string — 推送标题，最长 100 个字符。
  - `updatedAt` string, date-time
  - `updater` string
  - `updaterName` string — 修改人展示名；无法解析时回退 updater。

---

[API](https://skmtc.dev/apiqik/apis/apiqik-api.md) · [All operations](https://skmtc.dev/apiqik/apis/apiqik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apiqik/apiqik-api/revisions/e06b96127408/schema)