PUT `/admin/announcements/{announcement_id}`

Edit a specified announcement (editable only in draft status). Reference: CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance.

Notification Service `bearerAuth` application/json

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
`id`	`path`	`string`	Yes				Announcement ID

Schema: dto.UpdateAnnouncementRequest

Field	Type	Required
`content`	`string`	No
`expire_at`	`string`	No
`publish_at`	`string`	No
`target_roles`	array of string	No
`title`	`string`	No

Status	Description	Schema
200	Updated successfully	`dto.AnnouncementDetailResponse`
400	Invalid request parameters	`gitee_com_linmes_authms_base_dto.SimpleResponse`
401	Unauthenticated	`gitee_com_linmes_authms_base_dto.SimpleResponse`
403	Insufficient permissions	`gitee_com_linmes_authms_base_dto.SimpleResponse`
404	Resource not found	`gitee_com_linmes_authms_base_dto.SimpleResponse`
500	Internal server error	`gitee_com_linmes_authms_base_dto.SimpleResponse`

Field	Type	Required
`code`	`integer`	No
`data`	`dto.AnnouncementResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

Announcement info response

Field	Type	Required	Example
`content`	`string`	No	`The system will undergo upgrade maintenance on 2026-05-15`
`created_at`	`string`	No	`2026-05-09T12:00:00Z`
`dismissals`	`integer`	No	`5`
`expire_at`	`string`	No	`2026-05-20T12:00:00Z`
`id`	`string`	No	`ann_abc123`
`publish_at`	`string`	No	`2026-05-10T12:00:00Z`
`status`	`string`	No	`published`
`target_roles`	array of string	No
`tenant_id`	`string`	No	`tnt_xyz789`
`title`	`string`	No	`System upgrade announcement`
`updated_at`	`string`	No	`2026-05-09T12:00:00Z`
`views`	`integer`	No	`100`

Field	Type	Required
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No