diff --git a/Jellyfin.Api/Controllers/NotificationsController.cs b/Jellyfin.Api/Controllers/NotificationsController.cs
index 8da2a6c536..8feea9ab61 100644
--- a/Jellyfin.Api/Controllers/NotificationsController.cs
+++ b/Jellyfin.Api/Controllers/NotificationsController.cs
@@ -35,13 +35,14 @@ namespace Jellyfin.Api.Controllers
}
///
- /// Endpoint for getting a user's notifications.
+ /// Gets a user's notifications.
///
/// The user's ID.
/// An optional filter by notification read state.
/// The optional index to start at. All notifications with a lower index will be omitted from the results.
/// An optional limit on the number of notifications returned.
- /// A read-only list of all of the user's notifications.
+ /// Notifications returned.
+ /// An containing a list of notifications.
[HttpGet("{UserID}")]
[ProducesResponseType(StatusCodes.Status200OK)]
public ActionResult GetNotifications(
@@ -54,10 +55,11 @@ namespace Jellyfin.Api.Controllers
}
///
- /// Endpoint for getting a user's notification summary.
+ /// Gets a user's notification summary.
///
/// The user's ID.
- /// Notifications summary for the user.
+ /// Summary of user's notifications returned.
+ /// An containing a summary of the users notifications.
[HttpGet("{UserID}/Summary")]
[ProducesResponseType(StatusCodes.Status200OK)]
public ActionResult GetNotificationsSummary(
@@ -67,9 +69,10 @@ namespace Jellyfin.Api.Controllers
}
///
- /// Endpoint for getting notification types.
+ /// Gets notification types.
///
- /// All notification types.
+ /// All notification types returned.
+ /// An containing a list of all notification types.
[HttpGet("Types")]
[ProducesResponseType(StatusCodes.Status200OK)]
public ActionResult> GetNotificationTypes()
@@ -78,9 +81,10 @@ namespace Jellyfin.Api.Controllers
}
///
- /// Endpoint for getting notification services.
+ /// Gets notification services.
///
- /// All notification services.
+ /// All notification services returned.
+ /// An containing a list of all notification services.
[HttpGet("Services")]
[ProducesResponseType(StatusCodes.Status200OK)]
public ActionResult> GetNotificationServices()
@@ -89,13 +93,14 @@ namespace Jellyfin.Api.Controllers
}
///
- /// Endpoint to send a notification to all admins.
+ /// Sends a notification to all admins.
///
/// The name of the notification.
/// The description of the notification.
/// The URL of the notification.
/// The level of the notification.
- /// Status.
+ /// Notification sent.
+ /// An .
[HttpPost("Admin")]
[ProducesResponseType(StatusCodes.Status200OK)]
public ActionResult CreateAdminNotification(
@@ -120,11 +125,12 @@ namespace Jellyfin.Api.Controllers
}
///
- /// Endpoint to set notifications as read.
+ /// Sets notifications as read.
///
/// The userID.
/// A comma-separated list of the IDs of notifications which should be set as read.
- /// Status.
+ /// Notifications set as read.
+ /// An .
[HttpPost("{UserID}/Read")]
[ProducesResponseType(StatusCodes.Status200OK)]
public ActionResult SetRead(
@@ -135,11 +141,12 @@ namespace Jellyfin.Api.Controllers
}
///
- /// Endpoint to set notifications as unread.
+ /// Sets notifications as unread.
///
/// The userID.
/// A comma-separated list of the IDs of notifications which should be set as unread.
- /// Status.
+ /// Notifications set as unread.
+ /// An .
[HttpPost("{UserID}/Unread")]
[ProducesResponseType(StatusCodes.Status200OK)]
public ActionResult SetUnread(