feat: support custom notifications (#19751)

mirror of https://github.com/coder/coder.git synced 2026-06-02 20:48:20 +00:00

## Description

Adds support for sending an ad‑hoc custom notification to the
authenticated user via API and CLI. This is useful for surfacing the
result of scripts or long‑running tasks. Notifications are delivered
through the configured method and the dashboard Inbox, respecting
existing preferences and delivery settings.

## Changes

* New notification template: “Custom Notification” with a label for a
custom title and a custom message.
* New API endpoint: `POST /api/v2/notifications/custom` to send a custom
notification to the requesting user.
* New API endpoint: `GET /notifications/templates/custom` to get custom
notification template.
* New CLI subcommand: `coder notifications custom <title> <message>` to
send a custom notification to the requesting user.
* Documentation updates: Add a “Custom notifications” section under
Administration > Monitoring > Notifications, including instructions on
sending custom notifications and examples of when to use them.

Closes: https://github.com/coder/coder/issues/19611

This commit is contained in:

Susana Ferreira

2025-09-11 15:08:57 +02:00

committed by

GitHub

parent 4c98decfb7

commit eec6c8c120

26 changed files with 1056 additions and 30 deletions

									
										coderd/database/dump.sql
									
Generated

		+2
		-1
	
												View File
												
				@@ -150,7 +150,8 @@ CREATE TYPE notification_method AS ENUM (

				);

				CREATE TYPE notification_template_kind AS ENUM (

				    'system'

				    'system',

				    'custom'

				);

				CREATE TYPE parameter_destination_scheme AS ENUM (