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

# PATCH /v1/admin/model-square/banners/{bannerId}/status

`PATCH /v1/admin/model-square/banners/{bannerId}/status`

UpdateBannerStatus 上架 / 下架 Banner（仅平台管理员）。
 UpdateBannerStatus publishes/offlines a banner (platform admin only).

## Path parameters

- `bannerId` integer, required

## Request body

- ModelsquareV1UpdateBannerStatusRequest — UpdateBannerStatusRequest 上下架请求。/ UpdateBannerStatusRequest toggles status.
  - `bannerId` integer
  - `status` string — 目标状态：仅允许 PUBLISHED 或 OFFLINE。/ Target status: only PUBLISHED or OFFLINE.

## Response `200`

OK

- ModelsquareV1UpdateBannerStatusReply — UpdateBannerStatusReply 上下架响应。/ UpdateBannerStatusReply is the status reply.
  - `bannerId` integer
  - `status` string
  - `updatedAt` string, date-time
  - `updater` string

---

[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)