POST `/notifications/send`

Compatibility endpoint with same functionality as /notifications, sends notification to specified user. Reference: CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance.

Notification Service `bearerAuth` application/json

Request Body

Schema: dto.SendNotificationRequest

Field	Type	Required	Example	Description
`content`	`string`	Yes	`Your account has been successfully upgraded`	Content
`title`	`string`	Yes	`System notification`	Title
`user_id`	`string`	Yes	`usr_abc123`	User ID
`aggregation_key`	`string`	No	`new_follower`	Aggregation key (notifications with the same key are aggregated into one)
`metadata`	`object`	No		Metadata
`priority`	`string`	No	`medium`	Priority
`type`	`string`	No	`system`	Type

Responses

Status	Description	Schema
200	Sent successfully	`dto.SendNotificationCompatDetailResponse`
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`

Referenced Schemas

dto.SendNotificationCompatDetailResponse

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

dto.SendNotificationCompatResponse

Send notification response result (compatible endpoint)

Field	Type	Required	Example	Constraints	Description
`id`	`string`	No	`notif-1234567890`		Notification ID
`status`	`string`	No	`sent`		Status

gitee_com_linmes_authms_base_dto.SimpleResponse

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

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

POST /notifications/send