Autional Autional
API Reference GitHub autional.com →

POST /admin/announcements/{announcement_id}/unpublish

Withdraw a published announcement back to draft status (unpublish). Reference: CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance.

Notification Service `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
id path string Yes Announcement ID

Responses

StatusDescriptionSchema
200Withdrawn successfullydto.AnnouncementDetailResponse
400Invalid request parametersgitee_com_linmes_authms_base_dto.SimpleResponse
401Unauthenticatedgitee_com_linmes_authms_base_dto.SimpleResponse
403Insufficient permissionsgitee_com_linmes_authms_base_dto.SimpleResponse
404Resource not foundgitee_com_linmes_authms_base_dto.SimpleResponse
500Internal server errorgitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.AnnouncementDetailResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data dto.AnnouncementResponse No
message string No
timestamp string No

dto.AnnouncementResponse

Announcement info response

FieldTypeRequiredExampleConstraintsDescription
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

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No